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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created for Windows development. 


lie future has arrived—a complete 
point-and-click, WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 


Discover the ease and 
productivity ot visual 
development! 


Visually 

develop 

screens 



Create a menu 
and connect 
screens & dialogs 



Test the applica¬ 
tion's screen flow in 
a live environment 



Instantly generate 
source code in 
Pascal. C or C++ 
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add-on features, lik 


Paint your 
screens. Design 
a menu and link 
screens togeth¬ 
er. Test the flow 
in a live environ¬ 
ment, and gen¬ 
erate code for 
ANSI C, C++ 
for OWL or MFC 
or Pascal with 
objects. It's that 
easy. 

And this 

open! ProtoGen+ 
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compiler, 
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SQLView offer 
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Bring your applications to life using the latest 
visual design tools! 


workbench access to multiple The most powerful, open set of 

databases to develop client/server and Visual llevel0 ' lmen, Tools ever! 


xBase applications. Snap-in compo¬ 
nents make ProtoGen+ open to future 
development technologies—whatever 
they may be. 

ProtoGen+ is easy to learn, 
speeds your development cycle and 
protects your investment by generat¬ 
ing C.C++ and Pascal. We guarantee 
you'll 
prototype 
and generate 
exciting 
applications 
faster than 
you ever 




. 

>iq 
i—i 

; STftTlC 
= TEXT 

Jy 


IP 


b: 


(EDIT ft 

1 TEXT J_I 


M 


PUSH 

&UTTUH 



1 

■ 

[TftPfj 



Build win¬ 
dows. forms, 
dialog boxes, 
tool bars 

Output C. 
C++ and 
Pascal with 
Objects 

Create new 
designers! 
Source 
included 


Dialog 

Editor 

Menu 

Designer 

Quickly 
create a 
menu using 
templates 

Code 

Gener¬ 

ator 

ProtoView 

Screen 

Manager 

Data valida¬ 
tion, 3-D 
effects, MDI 
and more 

Custom 

Visual 

Designer 

Win- 

Control 

Library 

Rich library 
of visual 
control 
objects 


Snap-in 

Code 

Generators 


License our technology to 
create new code generators 
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Point-and-click to paint 
screens with bitmaps, 
icons, tables, data valida¬ 
tion, custom colors, fonts. 
3D effects, visual tool¬ 
bars, status lines, balloon 
help. MD1 and more! 
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Fasten your seatbelt 
for ProtoGen+! 

Only $199 (list price 

■ 800 - 231-8588 

Ask for Ext. 60 
In NJ, call (908) 329-8588 


The Visual Development Edge™ 

All products named are trademarks of their 
respective companies, ©1993 ProtoView Development 


ProtoGen+'s SQLView access to multiple 
databases Is available at an additional price; 
ask about it when you call. 
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No matter what database they throw at you, you’ll 
connect with INTERSOLV ODBC Rtck. 




Fastball, slider, or change-up. 
dBASE, Paradox, or Oracle. If you 
want to connect, you know 
you’ve got to react fast. 

With the comprehensive 
lineup of over 20 drivers in 
INTERSOLV ODBC Pack, you can. 

Cover all your bases with 
INTERSOLV. 

Drivers are the critical link 
between your ODBC-compliant 
applications, your network, and your 
databases. And because their quality 
directly affects the performance of 
your applications, it’s vital that you 
have superior drivers. 

Don’t risk costly errors. Rely on 
INTERSOLV for fast, dependable 
drivers. 

INTERSOLV ODBC Pack 
delivers: 

• Comprehensive coverage: Connect 
all ODBC-compliant applications to 
all major SQL and PC DBMS with 
INTERSOLV ODBC Pack. 

• Consistent access: INTERSOLV 
ODBC Pack drivers make all data¬ 
bases look the same so you don’t 
have to change the way you work 
every time you change databases. 

• State-of-the-art technology: 
INTERSOLV ODBC Pack gives you 
the same database access technology 
used by leading software publishers. 
Plus all drivers are certified through 
INTERSOLV’s ODBC Verification 
Suite. 

• High-level implementation: With 
INTERSOLV ODBC Pack you get 
full SQL, transaction processing, 
and even network locking support 
for non-SQL DBMS. Ana it’s the 


only set of drivers that 
sports a consistent level of ODBC 
Core, Level 1, and selected Level 2 
functions. 

• One-stop, cross-platform support: 
No other set of ODBC drivers offers 
the range of support available from 
INTERSOLV. Support is available 
for Windows OS/2, Windows NT, 
and Solaris; support for Macintosh 
will be available in late 1994. 

Complete, dependable, and 
quick, INTERSOLV ODBC Pack 
makes sure your applications 
perform — no matter 
what database you 
have to face. 


INTERSOLV ODBC Pack provides support for the 
following databases: 

ALLBASE, Btrieve, Clipper, DB2, DB2/2, DB2/6000, dBASE, Excel, FoxBase, FoxPro, Gupta 
SQLBase, IMAGE/SQL, INFORMIX, INGRES, Microsoft SQL Server, Netware SQL, Oracle, 
Paradox, PROGRESS, SQL/400, SQL/DS, Sybase SQL Server, Sybase System 10, Teradata, 
Text, and XDB. 

INTERSOLV ODBC Pack is available for Windows OS/2, Windows NT, and Solaris and 
will support Macintosh in late 1994. Not all DBMS are available on all platforms and 
some may require a gateway. Please call for details 


Order INTERSOLV 
ODBC Pack today! 

Make sure your ODBC com¬ 
pliant applications work tomorrow. 
Put INTERSOLV ODBC Pack on 
your team today! Purchase directly 
from INTERSOLV. At only $199. 
it’s a steal! 

Get a free ODBC booklet! 

Be sure to request your FREE 
copy of Getting Connected — 

An ODBC Primer, whether 
you order INTERSOLV 
ODBC Pack or not. Call: 

1 - 800 - 876-3101 

ext. D019, 8 am to 8 pm EST. 


INTERSOLV 


©INTERSOLV, Inc, All rights reserved. INTERSOLV, Excelerator, Maintenance Workbench, PVCS, AND Q+E are registered trademarks 5540 Centerview Drive, Suite 324 • Raleigh, NC 27606 
and APS is a trademark of INTERSOLV, Inc. Other company or product names mentioned herein may be trademarks or registered 800-876-3101,(919) 859-2220, Fax (919) 859-9334 

trademarks of their respective companies. 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 


Discover the secrets the insiders use 
with Windows Source! 

Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

❖ Identifies all imported function 
calls, including Windows API calls. 

❖ Labels all exports from an execu¬ 
table, DLL or device driver. 

❖ Includes Codeview symbols when 
available. 

❖ Identifies, by name, the VxD API 
entry points and services provided. 

❖ Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $229.95! 

Call 800-648-8266 
to order now! 

\ f—JH V Communications, Inc. 

\\ Tf / 4 4320 Stevens Creek Blvd., Suite 275-WD 
V* San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 



From 

the Editor 


l don't know if it's true that everyone has one good novel in them, but I do 
believe that every programmer has at least one good magazine article in 
them. If you've got ideas, or expertise in search of ideas, getting started can be 
as easy as sending me email. See the Call for Papers on page 66 or just drop 
me a note at 70302.2566@compuserve.com. ♦♦ Want to test your mettle against 
other programmers? Check out the 1994 Developers Competition, October 6-8 
in Durham, North Carolina, (919) 383-9749, 71333.3015@compuserve.com There 
are prizes, competing teams from around the world, and a parallel conference 
with classes. ♦♦ Can it get any easier to obtain product information? Turn 
to pages 56-57 for our new Advertiser Index and you can get your information 
direct, via the post office, via FAX, and even via email (wdrs@rdpub.com)! 
Also, don't forget you can send email to wdsub@rdpub.com to subscribe, re¬ 
new, replace a missing or damaged issue, or access most any subscription-re¬ 
lated service (you can even buy a T-shirt). ♦♦ Eiffel is an interesting OOP 
language that's been around for some time, initially documented in Bertrand 
Meyer's excellent book Object-Oriented Software Construction (1988, Prentice 
Hall). I wrote the language off in my mind, since Eiffel compilers were not 
readily available for the PC. However, I just got a press release about Personal 
Eiffel for Windows for $49.95 - maybe cheap enough to motivate a look-see. 
Check out the New Products section for more details. ♦♦ Every so often, 
Byte slips in a down-and-dirty technical PC programming article; such was the 
case in the July 1994 issue, in which Terje Mathisen explores the undocu¬ 
mented machine-specific registers (MSRs) of the Pentium - you can use them 
to perform very high-speed profiling of code, accessing a phalanx of cool inter¬ 
nal chip statistics, such as pipeline stalls, branches, data read/write misses, mis¬ 
aligned data references, and so on. Needless to say, Intel should just release 
the documentation and save everyone time. ♦♦ I don't think I'm famous, 
and I'm verifiably not rich, but somehow my name appears in Seth Godin's 
new book E-mail Addresses of the Rich and Famous ($7.95, Addison-Wesley, ISBN 
0-201-40893-7). I believe this is the first time my name has appeared in a 
book along with Beavis and Butthead ( beavis@mtv.com and butthead@mtv.com, re¬ 
spectively). Now my life is complete. ♦♦ Azalea Software is offering a free 
document, frequently asked questions (FAQ) about barcodes. Send email to 
azalea@igc.org to obtain a free copy. 


Ron Burk 

Editor 

CIS: 70302,2566; Internet: ronb@rdpub.com (",..!uunet!rdpub!ronb") 
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Watoom C/C++ 1(L0 


ACCELERATE 

Your C and C++ 
Application Development 


Watcom International 415 Phillip Street, Waterloo, Ontario, Canada N2L 3X2 Telephone (519) 886-3700 Fax (519) 747-4971 

■ Price in US dollars. Does not include freight and taxes where applicable. Authorized dealers may sell for less. $199 Special Offer is available until October 31,1994. Watcom and the Lightning Device are trademarks of Watcom International Corp. 
DOS/4G is a trademark of Rational Systems Inc. Other trademarks are properties of their respective owners. ©Copyright 1994 Watcom International Corp. ’PC Magazine, March 29,1994 


The advanced multi-platform debugger accelerates the 
development cycle by increasing the bandwidth between 
you and your application. 


1-800-265-4555 WatCOIII 

A Powersoft Company 


Watcom C/C++ 10.0 includes a source editor with syntax 
highlighting, a suite of resource editors, testing and 
monitoring tools for Windows 3.x and NT development. 


Suggested Retail Price: 

Watcom C/C++10.0 CD-ROM Edition * 

( CD-ROM with on-line documentation) $350 

Watcom C/C++10.0 

(CD-ROM with printed documentation) 

Upgrades: 

(tor owners of Watcom C/C++ 31 or Watcom C/C++' 1 v9.5) 

Watcom C/C++10.0 

CD-ROM Upgrade Edition $149 


•And more! 


New Integrated Development 
Environment and Tools The new ide is 


built to simplify the complexities of real-world 
application development and make it easy to exploit m 
the high-performance, multi-platform power of 
Watcom C/C++ 10.0. In a single “project” you can s 
build multiple EXEs, DLLs, and LIBs, targeting J, 
several different platforms. The IDE simplifies each 
stage of development from compiling and linking to 
debugging and performance tuning. The package 
includes versions of the IDE and tools for all three host 


platforms (Windows 3.x, OS/2 2.x and Windows NT)* 


ultiple Platforms in a Single 

Package Watcom C/C++ 10.0 supports 
' development of applications targeting an 
Jftncredible array of platforms: DOS, Windows 
l.x, OS/2 1.x, 32-bit DOS (includes royalty-free 
!)OS extender), OS/2 2.x, Windows NT, Win32s, 
32-bit Windows 3.x and Novell NLMs. To 
Jtmaximize the potential on individual 
platforms, Watcom C/C++ 10.0 extends the 
’ capabilities of the core, multi-platform toolset 
' with platform-specific tools, SDKs and libraries. 
This extensive support is amplified by the cross¬ 
platform capabilities of the IDE and tools, which enable 
1 building applications for a wide range of target 
T environments from any of the host systems. 

The Best Optimization Technology watcom C/C++ 10.0 

Combines both 16- and 32-bit compilers in a single package, providing 
f you with the industry-leading optimizing compiler team. PC Magazine 
r tested performance of industry standard C and C++ compilers and said: 

“the fastest executables created during testing came from Watcom C/C++ 32 , 

F Version 9.5, while the 16-bit version of the same compiler produced the smallest 
executables” 1 . Now, with Watcom C/C++10.0, this competitive advantage is 
r delivered with our easy-to-use development environment and tools. 


watcom 


C/C++10.0 delivers all this in a single package! 


• New integrated development environment 
hosted on Windows, OS/2 and Windows NT 
Comprehensive suite of multi-platform 
development tools including debugger, 
browser, profiler and more 
Professional source editor, resource editors, 
testing and monitoring tools hosted on 
Windows and Windows NT 
Target Platforms include: 

16-bit: DOS "Windows 3.x* OS/2 1.x 
32-bit: Extended DOS • Windows NT 
•Win32s "OS/2 2.x "32-bit 
Windows 3.x • Novell NLM 
• AutoCAD ADS/ADI 


• Both 16-bit and 32-bit compilers for C and C++, 
the industry's best code optimizer, faster compile 
times with pre-compiled headers, C++ supports 
templates, exception handling and the Microsoft 
Foundation Class library (MFC) 

• Licensed components from: 

• Microsoft Windows 3.1 SDK 

• Microsoft Windows NT SDK 

• Novell NLM SDK v4.0 

•IBM OS/2 Toolkit v2.1 

• Microsoft MFC Class library 

• Includes Rational System's DOS/4GW 32-bit 
DOS extender with royalty-free distribution 

• Significantly expanded and revised 
on-line documentation 


The new Watcom C/C++ 10.0 
development system simplifies and acceler¬ 
ates development of high-performance, 
multi-platform 16-and 32-bit applications. J 
Watcom C/C++ 10.0 delivers productivity | 
and performance, combining our state-of- | 
the-art compiler technology with a new, l 
integrated development environment 
(IDE) and comprehensive set of tools. ! ^| 


□ Request 110 on Reader Service Card □ 

































































Memory Management 



Far Pointers for Huge Memory 

Paul Bonneau 


[03 


Visual C++ vl.5 
Borland C++ v4.0 
Symantec C++ v6.1 


Even though Windows is on the path to freeing itself from the segmented 
Intel architecture with its 64Kb restrictions, there remain millions of lines of 
code limited by the addressing constraints that segmentation imposes. Not only 
is it impractical to rewrite ail of this legacy code, but in many cases, the source 
is not available. This article presents a technique you can use to create a far 
pointer to address any location in a huge block of memory. You can pass this 
far pointer to legacy routines (routines that can only handle 64Kb of data), 
move the pointer further up in the huge block, and iterate until the entire huge 
block has been processed by the legacy routine. 

The Problem 

Under 16-bit, protected-mode Windows, 32-bit pointers consist of a selector 
(the upper 16 bits) and an offset (the lower 16 bits). This pointer is not simply a 
32-bit offset into physical memory. Instead, the hardware uses the 16-bit selec¬ 
tor as an offset into the local descriptor table, or LDT. The LDT is a series of 
eight-byte descriptors, each of which describes the location, size, permissions, 
etc., of a particular memory segment. After using the selector as an offset into 
the LDT to locate a descriptor, the hardware adds the address in the descriptor 
to the pointer's 16-bit offset to obtain an actual memory location. It is actually 
more complicated than that, but this description suffices for the purpose of 
explaining the problem with huge memory. 

A major problem of segmented memory is how to address huge memory 
blocks (those whose size is greater than 64Kb). Since the offset portion of the 
pointer is only 16 bits, it cannot address memory more than 64Kb past the 
start of the first address referenced by the 16-bit selector. You might think that 
you could increment the selector portion of the pointer by one, and reset the 
offset to zero to address the next 64Kb, but the hardware does not enforce any 
particular relationship between sequential selectors - selector number 0x0048 
might refer to a memory segment many megabytes away from the memory 
segment referred to by selector number 0x0040 (remember that a selector is an 
index into a table of eight-byte entries, so the next valid selector after 0x0040 is 
0x0048). Thus, implementing huge pointers in C requires the cooperation of both 
the operating system (to arrange a set of sequential selectors with specific val¬ 
ues) and the compiler (to handle the manipulation of the selector and offset 
portions of the pointer). 


Paul Bonneau was a developer of HyperChem, a molecular modeling system, and 
more recently, of Creative Writer, a word processor for children. He works for Microsoft 
Corporation as a Software Design Engineer. The opinions expressed in this article are 
Paul's alone and not those of Microsoft. 
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Phar Lap FrontRunner... 

The Winning DOS Desktop for Windows 



LAUNCH BAR 

FrontRunner’s Launch Bar offers 
one-button launching of your favorite 
applications. Customize it any way 
you like! 


COPY & PASTE 

Just highlight and click to copy and 
paste any part of your DOS session into 
a Windows or DOS program. 


COMMAND LINE POWER 

Run DOS or Windows programs right 
from the DOS prompt! 

• 

POWERFUL REAL TIME 
STATUS BAR 

FrontRunner’s Status Bar displays 
real-time information including 
system resources... and lets you 
write modules to display your own 
up-to-date information! . 


Bringing the best of DOS to 


SIMPLIFIED RUN MENU 

Run Menu offers Program Manager functionality 
without navigating through all those open windows! 


HISTORY 

Scroll to view the complete 
history of your DOS session. 


«S5» 

31 


nging 

Windows ••• And the Power 
of Windows to DOS 

Frustrated with switching between 
Windows and DOS applications? Now 
you can get the command-line power 
you need — integrated with the 
Windows graphical features you want. 
Phar Lap FrontRunner is a powerful 
DOS-based Windows desktop that 
brings intuitive GUI features to 
command-line DOS. FrontRunner lets 
you run Windows programs directly 
from the DOS prompt, provides an easy- 
to-use, menu-driven alternative to 
Program Manager, lets you launch 
applications with a click, keeps custom 
information at hand with Phar Lap’s 
unique Status Bar, and much more! 


FfantfCunner - [Command Shell Window ffl [Suspended]] 


File Edit Settings Tasks^-Run Window Help 


# fl 


AUTOEXEC 001 
SC0NC0DE 
AUTOEXEC 002 
AUTOEXEC 003 
AUTOEXEC B~K 
DATA TXT 

DU EXE 


541 09-01- 
3328 11 09 
541 11-05- 
541 11 08 
535 12 09- 
188 08-19- 
2179334 09-09- 


0PT2_WS <DIR> 12-07- 



iv 11 y 

r!Hedemo 

WW60BEM0 
WPPDEMO 
PUB0EM0 
PUBDEM02 
W0RKDEMQ 
AUTOEXEC BAT 
ADEDEMO 
INTERACT 


UL1rUtMu 

WPPDEMO2 

JP52DEM0 

XMAS93 

FRONT 

HJPR0 


<DIR> 12-07-93 

<BIR> 12-07-93 

<0IR> 12-07-93 

<0IR> 12-07-93 

<0IR> 12-09 93 

<0IR> 12-16-93 

<0IR> 12-16-93 

647 12-30-93 
<0IB> 12-16-93 

<DIR> 12-16-93 


n:l2p 
4:20p 
4:27p 
4:33p 
12:27p 
3:52p 
3:55p 
2:23p 
4:01 p 
4:14p 


File Edit Find Character Paragraph 
Document Help 


... JEflO <8 R> 

Wriu < DIR > 1 

' DIO DIR> 1 

•. .'-trio d:r> 

■102 <DIR> 

WORKDEMO <DIR> 

- BflT 647 


§gff 

INTERACT 



— 1 / —. _ 

12-17-93 11:15a 

12-17-93 11:55a 

12-21-93 10:13a 

12-27-93 2:56p 

12-30-93 11:15a 

2249532 bytes 
130850816 bytes free 


OPTIVITY <C 17245K 11:33 AM 


♦ | 


C: 130.797,568 




FRONTRUNNER OFFERS YOU: 

A Better DOS Box — Scroll and 
view your entire DOS screen 
history and run Windows programs 
directly from the DOS prompt 

✓ Quick and Easy Program Manager 
Replacement — no more searching 
through all those windows 

✓ Customizable Launch Bar — instant 
access to your favorite programs 

✓ Powerful Visual Batch Language 
Extensions for DOS — easily 
create visual front ends 

✓ Programmable Status Bar — view 
the real-time information you need 
most 

✓ Versatile Utilities — to enhance 
your productivity 



Coil Now 
To Order 
Or To Get Your 
Free Demo! 

1 - 800 - 292-9622 


Now you can test ride a winner with our 
free FrontRunner Lite and Guided Tour 
Demo disks. FrontRunner Lite is a trial¬ 
sized version of our DOS desktop for 
Windows that lets you try all of 
FrontRunner’s powerful features... 
absolutely free! So call today and see 
how exciting a winning DOS desktop 
can be! 




60 Aberdeen Avenue, Cambridge, MA 02138 617-661-1510 FAX: 617-876-2972 


Phar Lap® and FrontRunner® are registered trademarks of Phar Lap Software, Inc. All other product names and company names are trademarks or registered trademarks of their respective holders. 
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Peter Gulutzan 
Trudy Pelzer 


Embedded SQL in C 


Optimizing SQL 

by Peter Gulutzan and Trudy Pelzer 

Optimizing SQL explains the basics 
and subtleties even some experts 
don’t know. Careful comparisons 
demonstrate how to improve SQL 
performance and 17 rules-of-thumb 
guide efficient applications. 


Learn ODBC and dynamic 
(machine-generated) 
embedded SQL 

This book explains Microsoft’s Open Database 
Connectivity interface. You will also learn how to 
embed SQL in C, how and when to use indexes, and 
coding for portable applications. 



OPTIMIZATION RULE-OF-THUMB *1 


If you have two or more AND ed expressions put 
the most limiting expression first. 


Query A 
SELECT * 

FROM ITEMS 
WHERE PRICE = 600 


Query B 
SELECT * 

FROM ITEMS 
WHERE .35 = DISCOUNT 


Query A 

DBMS #1 100% 

DBMS #2 100% 

DBMS #3 100% 


Query B 
200 % 
200% 
200% 



Optimizing SQL 

also contains these programming aids: 

■ A summary of SQL commands. 

■ A “Hello World" program demonstrating static 
embedded SQL. 

■ A lengthy sample program in dynamic 
(machine-generated) embedded SQL. 

■ A "toolkit" program for checking index status. 

■ A complete sample ODBC application. 

■ 17 rules-of-thumb for more efficient SQL. 

■ A free enclosed diskette with: 

- All programs in the text 

- Sample database libraries for DOS and 
Windows 

- An embedded SQL Precompiler 


Order Your Copy Today! 

Use code V01 for Optimizing SQL with disk. 


Book with disk 

$ 34 §§ 


plus shipping 


O 

i 

DISK 

INCLUDED 



Technical 

Books 


913-841-1631 
FAX: 913-841-2624 
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Suppose you call GlobalAllocO to allocate 256Kb of 
memory. Because this is more than 64Kb, Windows allo¬ 
cates four (256/64) sequential selectors. It causes the first 


selector to refer to the beginning of the 256Kb memory 
segment, the second selector to refer to the byte at offset 
64Kb within the memory segment, and so on, as shown 


Listing 1 contents, c — Far access to huge memory demo 


/A****************************************************/ 

/* contents.c */ 

/* -- Demonstrates providing protect mode "window" */ 
/* into large 064KB) block of memory. */ 

/* -- To build: cc -d -DSTRICT contents.c commdlg.lib*/ 

/A****************************************************/ 

♦include <windows.h> 

♦include <windowsx.h> 

♦include <commdlg.h> 

♦include <memory.h> 

♦include <limits.h> 

♦define midOpen 1000 /* Open file menu item id. */ 

♦define cbBuf 0x00010000 /* 64KB buffers. */ 

/* Maximum line map size. */ 

♦define clinMax ((cbBuf / sizeof(DWORD)) - 1) 

/* Window offsets into for text and line map ptrs. */ 

♦define ibText 0 

♦define ibMap sizeof(LPSTR) 

const char szClass[] = "ContentsClass"; 
const char szTitle[] = "Contents"; 

LRESULT CALLBACK _export LwWndProc(HWND hwnd. UINT wm. 

WPARAM wParam, LPARAM IParam); 
void ReadText(HWND hwnd); 
void PaintText(HWND hwnd); 
void ScrolIText(HWND hwnd. int ilin, int wType); 

/* Selector functions. */ 
void FreeSeKWORD sel); 


DWORD IbBaseGetSeKWORD sel); 

WORD SelAlloc(DWORD IbLin); 

void SetBaseSelIb(WORD sel. DWORD IbBase); 

WORD SelAlloc(DWORD IbLin) 

/ ***************************************************** / 
/* -- Allocate and Initialize a LDT selector. */ 
/* -- ibLin : Limit to set for selector. */ 

/*****************************************************/ 

{ 

WORD sel; 

_asm mov ax. 0000h; /* Allocate the selector. */ 

_a$m mov cx. 0001h; 

_asm int 31h; /* Should check for success. */ 

_asm mov sel. ax; 

if (0x00100000 < ibLin) 

IbLin |= 0x0fff; 

_asn mov ax, 0008h; /* Set the limit. */ 

_asm mov bx, sel; 

_asm mov cx. WORD PTR [ibLin + 2]; 

_asm mov dx. WORD PTR [ibLin]; 

_asm int 31h; /* Should check for success. */ 

_asm mov ax. 0009h; 

_asm mov bx, sel; /* Set the access rights. */ 
_asm mov cx, 00f3h; 

_asm int 31h; /* Should check for success. */ 

return sel; 

) 


void SetBaseSelIb(WORD sel. DWORD IbBase) 

/*****************************************************j 

/* -- Set the base address for the selector. */ 

/*****************************************************/ 
{ 

_asm mov ax, 0007h; 

_asm mov bx, sel; 

_asm mov cx, WORD PTR [ibBase + 2]; 

_asm mov dx, WORD PTR [ibBase]; 

_asm Int 31h; /* Should check for success. */ 

} 

DWORD IbBaseGetSel (WORD sel) 
/*****************************************************/ 
/* -- Get the base address for the selector. */ 

/*****************************************************/ 

{ 

DWORD 1b; 

.asm mov ax, 0006h; 

.asm mov bx, sel; 

.asm int 31h; /* Should check for success. */ 

.asm mov WORD PTR [ib + 2], cx; 

.asm mov WORD PTR [ib], dx; 

return ib; 

} 

void FreeSeKWORD sel) 

/*****************************************************/ 
/* -- Frees the given selector. */ 

/***************************************************** j 
{ 
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“At a glance, you can tell the status of any defect or 
change order, who is responsible for correcting the 
defect or implementing the change, and when the 
updated version is expected ” 
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FOR WINDOWS™ - 
PROFESSIONAL SOFTWARE 
TRACKING TOOL. 

• GENERATE POWERFUL REPORTS & GRAPHS 

• IMPORT/EXPORT/MERGE DATABASES 

• CUSTOMIZE THE SETUP TO YOUR NEEDS 

• NETWORK SUPPORT 

FOR MORE INFORMATION, CALL: 

41 5-567-401 O 

47 67 1 5 67 OO 
47 67 1 5 67 Ol 


^utions. 



IN EUROPE, CALL: 

FAX: 


Archimedes 

SOFTWARE 


Archimedes Software, Inc. 2159 Union Street, San Francisco, CA 94123 
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in Figure 1. In 80x86 jargon, Windows has allocated a set 
of 'tiled' selectors for you, to span the 256Kb memory 
block. Again, each of the tiled selectors has a value equal 


to the previous selector plus eight, due to the fact that 
they are indices into a table of eight-byte descriptors. 


Listing 1 continued 


_asm mov ax, 0001h; 

_asm mov bx, sel; 

_asm int 31h; 

} 

#1fdef _BORLAHDC_ 

#pragma argsused 
lendif 

Int PASCAL WinMaln(HINSTANCE bins, HINSTANCE hinsPrev, 
LPSTR lpsz. Int wShow) 

/*****************************************************/ 
/* -- Entry point. */ 

/*****************************************************/ 
{ 

HWND hwnd; 

MSG msg; 

if (NULL == hinsPrev) /* Create main class. */ 
{ 

WNDCLASS wcs; 

wcs.style = CSJREDRAW I CS_VREDRAW; 
wcs.lpfnWndProc = LwWndProc; 
wcs.cbClsExtra = 0; 
wcs.cbWndExtra = 
sizeof(LPSTR) + sizeof(LPLONG); 
wcs.hlnstance = bins; 

wcs.hlcon = LoadIcon(NULL, IDI_APPLICATION); 
wcs.hCursor = LoadCursor(NULL, IDC_ARROW); 
wcs.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1); 
wcs.lpszMenuName = NULL; 
wcs.lpszClassName - szClass; 
RegisterClassUwcs); 


} 

hwnd = CreateWindow(szClass, szTitle, 
WS_OVERLAPPEDWINDOW, CWJSEDEFAULT, 

CW_USEDEFAULT, CWJSEDEFAULT. CWJSEDEFAULT. 

NULL. NULL, bins, NULL); 

/* Lazy -- put Open File on system menu. */ 
AppendMenu(GetSystemMenu(hwnd, FALSE). MF_STRING. 
midOpen. "iOpen..."); 

ShowWindow(hwnd, wShow); 

while (GetMessage(&msg. NULL. NULL. 0)) 

( 

TranslateMessage(Amsg); 

DlspatchMessage(Amsg); 

) 

return msg.wParam; 

) 

void ReadText(HWND hwnd) 

/*****************************************************/ 
/* -- Read the file into memory. */ 

/*****************************************************/ 


{ 


HFILE 

hfil; 

/* Input file. */ 

OPENFILENAME ofn; 

' Needed by GetOpenFIleNaue. */ 

char 

szBuf[256], szPath[128], szF11e[13]; 

DWORD 

cb; 

/* Size of file. */ 

DWORD 

ibBase; 

/* Linear memory address. */ 

DWORD 

1b; 

/* Linear memory offset. */ 

Int 

clin; 

/* Number of lines in file. */ 

WORD 

sel; 

/* Selector. */ 


HGLOBAL hgbl; /* Text buffer global handle. */ 

LPSTR lpch; /* Synthesized character ptr. */ 

LPLONG lprgib; /* Line map. */ 

memsetUofn, 0, sizeof ofn); /* Prepare for the */ 
szPath[0] = szF11e[0] = ’\0’; /* open file */ 

ofn.lStructSIze = sizeof ofn; /* dialog. */ 

ofn.hwndOwner = hwnd; 

ofn.1pstrFIlter = "Text (*.txt)\0*.txt\0"; 

ofn.nFilterlndex * 1L; 

ofn.lpstrFile = szPath; 

ofn.nMaxFile = sizeof szPath; 

ofn.lpstrFileTitle = szFile; 

ofn.nMaxFileTItle = sizeof szFile; 

ofn.Flags = OFNJIDEREADONLY | OFN_FILEMUSTEXIST; 

If (!GetOpenFi1eName(&ofn) || 

NULL == (hfil = _lopen(szPath. READ))) 
return; 

wsprintf(szBuf. "Xs - Xs". /* Show name in */ 
(LPSTR)szTitle, (LPSTR)szFile); /* caption. */ 
SetWindowText(hwnd, szBuf); 

cb = _llseek(hfil. 0. 2); /* Get file size. */ 

_llseek(hf11, 0. 0); 

/* Get space and read It Into memory. */ 
lpch = (LPSTR)GetWindowLong(hwnd. IbText); 
lpch = GlobalReAllocPtrdpch, cb. GMEM_MOVEABLE); 
_hread(hf11. lpch. cb); 

Jclose(hfll); 

((char huge *)lpch)[cb - 1] = 0; /* Null term. */ 

SetWindowLong(hwnd, IbText. (long)lpch); 



Version 7.0 For DOS, DOS ’286, OS/2, Windows and Windows NT 

• High resolution vector graphics * Convert high-resolution output to 
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you to create every sort of scientific and engineering plot. No 
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Scientific Endeavors Corporation 
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Powersoft™ already has the 
best team application development 
tool in the business. The industrial- 
strength PowerBuilder® Enterprise. 
Now we’ve brought the brawn of this widely accepted, 
award-winning success to xBase and desktop developers 
with PowerBuilder Desktop. 

Better yet, we’ve done it in the first package that 
combines a client/server architecture with object-oriented 
programming. The result is the industry’s most powerful, 
graphical desktop development tool available. 

What’s more, you’ll always find a smooth ride down 
the application development road. We’ve paved it with 
innovative programs including automated technical 


support, certification courses, and access to a vast 
network of PowerBuilder Desktop developers like your¬ 
self through CompuServe? user groups, and more. And 
PowerBuilder Desktop provides a strong foundation 
for full-featured team development by simply adding 
our robust companion products, which are listed in 
the column on the right. 

So if you’re searching for a client/server application 
development tool that’s proven, scalable, affordable 
($249*), and will fit on your desktop, look no further 
than PowerBuilder Desktop. Find it at CompUSA, 
Egghead, and Micro Center. Or call Powersoft 

a, 1-800-395-3525. P()WGPS0ft 
Building on the power of people. 



Object Easy 

° Inheritance, 
polymorphism, and 
encapsulation 

° Class libraries 
° Custom controls 
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SQL Smart™ 

° Integrated database 
administrator and 
dictionary 
° Built-in 32-bit 
Watcom™ SQL 
° Intelligent 
DataWindow™ object 
° Supports popular 
desktop databases 

Developer 

Designed 

° Rapid iterative 
development 

° Complete Windows® 

3.1 support 

° Full MDI support 

° OLE, DDE and DLL 
support 

° Configurable toolbars 
° Extensive on-line help 
° Integrated debugger 
° Robust PowerScript™ 
language with hundreds 
of extensible functions 
° Royalty-free deployment 
(deployment kit free 
with registration) 

Tools for 
Scalable Team 
Development 

° Upgrade seamlessly 
to our enterprise-wide 
client/server environment 
with PowerBuilder 
companion products. 

° PowerBuilder 
Team/ODBC Kit 
° PowerBuilder Enhanced 
Database Kit 

° PowerBuilder 
Application Library 

° PowerBuilder Developer 
Toolkit 

Databases 

Supported 

° Broad Connectivity - 
In addition to Watcom 
SQL, access the databases 
below using the drivers 
included: * 

° dBase III, IV 
° Fox Pro 1.x, 2.x 
° Microsoft Access 
° Microsoft Excel 
° Paradox 3.x, 4.x 
° Btrieve 5.x, 6.x 
o ASCII 

° Clipper Summer 87,5.x 
° NetWare SQL 

" Package includes 
Microsoft™ and Q+E™ 
drivers 


Powersoft Corporation, 561 Virginia Road, Concord, MA 01742-2732. Powersoft Europe Ltd., Thames House, 1 Bell Street, 
Maidenhead, Berkshire, SL6 1BU, United Kingdom. " Introductory price for a limited time only. Prices listed do not include sales tax, 
shipping and handling. All trademarks and registered trademarks are property of their respective owners. 
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Now consider what has to happen to increment a 
pointer through all of the bytes in the huge, 256Kb mem¬ 
ory segment. To point to the first byte, you would load 


the first of the tiled selectors into the upper half of the 
pointer, and zero into the lower half of the pointer. To 
address the next byte, you would just increment the lower 


Listing 1 continued 


/* Allocate and prepare new selector. */ 

GlobalF1x(hgbl = GlobalPtrHandle(lpch)); 

sel = SelAlloc(0x0000ffff); 

ibBase = IbBaseGetSel(SELECTOROF(lpch)); 

/* Build up line map. */ 

lprgib = (LPLONG)GetWindowLong(hwnd. ibMap); 

1prgib[0] = 0; 
clin = Is 

/* Loop until no more lines or no more room. */ 
for (ib = 0; ib < cb && clinMax > clin; 

1 b++, lpch++) 

if ((*1pch == *\r' && ib + 1 < cb && 
lpchCl] == ’\n') || 

OFFSETOF(lpch) == 0xffff) 

{ 

/* Hew line or max line length. */ 

*lpch = 0; 

lprg1b[clin++] = lb + 2; 

/* Start over from current spot. */ 
SetBaseSelIbCsel. ibBase + ib); 

1pch = MAKELP(sel. 0); 

} 

lprgibCclin] = -1; /* Mark end of map. */ 

/* Adjust scroll bar. */ 

SetScrol 1 RangeChwnd. SBJERT. 0. clin - 1. FALSE); 
SetScrollPos(hwnd. SBJERT. 0. TRUE); 


GlobalUnfix(hgbl); 

} 

void PaintText(HWND hwnd) 

/*****************************************************/ 
/* -- Handle a paint message. */ 

/* -- Paint the text for the current scroll pos'n. */ 
/*****************************************************/ 


{ 


WORD 

sel; 

/* Selector. */ 

HGLOBAL 

hgbl 

/* Text buffer global handle. */ 

LPSTR 

lpsz 

/* Synthetic string pointer. */ 

LPLONG 

lpib 

/* Line map entry pointer. */ 

PAINTSTRUCT 

wps; 

/* For BeginPaintO/EndPaintO. */ 

RECT 

rect; 

/* Client area. */ 

Int 

y. dyText; /* Coordinates. */ 

Int 

lin; 

/* Line index. */ 

DWORD 

ibBase; /* Linear memory address. */ 


BeglnPaintdiwnd. &wps); 

dyText = HIWORD(GetDialogBaseUnitsO); 

/* Allocate and prepare selector for text. */ 
lpsz = (LPSTR)GetWindowLong(hwnd, ibText); 
GlobalF1x(hgbl = G1obalPtrHandle(lpsz)); 
sel = SelA11oc(0x0000ffff); 

/* Get line number and map entry. */ 
lpib = (LPLONG)GetWindowLong(hwnd. ibMap); 

1 pib += (lin = GetScrollPos(hwnd. SBJERT)); 

/* Loop over lines in client area. */ 
GetClientRect(hwnd. irect); 


ibBase * IbBaseGetSel(SELECTOROF(lpsz)); 
lpsz = MAKELP( sel, 9); 

for (y = 0; y < rect.bottom; y +* dyText. Ip 1 b++) 

{ 

If Opib[l] <* -1) 
break; 

SetBaseSelIbCsel. ibBase + *lpib); 
ExtTextOut(wps.hdc, 0. y, 0. NULL, lpsz. 
lstrlen(lpsz), NULL); 

} 

FreeSel (sel); /‘Cleanup.*/ 

G1obalUnf1x(hgbl); 

EndPaint(hwnd, &wps); 

) 


LRESULT CALLBACK _export LwWndProc(HWND hwnd. UINT wm. 
WPARAM wParam. LPARAM IParam) 



{ 

LPLONG lprgib; 


switch (wm) 

{ 

default: 

break; 

case WM_CREATE: /* Allocate line map and Initial */ 
SetWindowLong(hwnd. IbText. /* text buffer. */ 
(LONG)G1obalA11ocPtr(GMEM_MOVEABLE. cbBuf)); 
lprgib = G1obalA11ocPtr(GMEM_MOVEABLE. cbBuf); 
IprglbCl] = -1; /* No lines. */ 

SetWindowLong(hwnd, IbMap, (LONG)lprglb); 
SetScrollRange(hwnd. SBJERT. 0. 0. TRUE); 
break; 

case WMJJESTROY: /* Free memory. */ 

GlobalFreePtr(GetWindowLong(hwnd. IbText)); 

G1obalFreePtr(GetWindowLong(hwnd. ibMap)); 

PostQuitMessage(0); 

break; 

case WM.PAINT: 

PaintText(hwnd); 
return 0; 

case WHJSCROLL: 

ScrollText(hwnd. LOWORD(lParam), wParam); 
return 0; 

case WM_SYSCOMMAND: 

If (midOpen == wParam) 

{ 

ReadText(hwnd); 
return 0; 

} 

break; 

} 

return DefWindowProc(hwnd. wm. wParam. IParam); 

} 

void ScrollText(HWND hwnd, int 11 in. Int wType) 

/*****************************************************/ 
/* -- Scroll the text In the window. */ 

/*****************************************************/ 
( 

Int clInMIn, clInLim, clInRect: 

RECT rect; 

GetScrollRange(hwnd. SBJERT. iclInMIn, AclInLIm); 
If (0 == clInLim) 
return; 

GetClientRect(hwnd, Irect); 
clInRect = 

rect.bottom / HIWORDCGetDIalogBaseUnits()); 

If (wType !* SBJHUMBPOSITION && 
wType != SB_THUMBTRACK) 

{ 

11 In = GetScrol 1 Pos(hwnd. SBJERT); 
switch (wType) 


FreeSel (sel); /‘Cleanup.*/ 



Coding with standard I/O libraries is fraught with 
danger—file-offset errors, cryptic file formats, and 
datatype access errors. 

Introducing Gamelon, an object-based, platform- 
independent, I/O library that is setting new safety 
standards for file I/O. Gamelon provides type-safe 
file access and eliminates file-offset errors. Free-form 
file layouts hold BLOBs, aggregates, and elementary 
data types. Gamelon protects your data so that you 
can work safely and more productively. 

Does your I/O library meet today’s safety standards? 
For more information about Gamelon, contact 
MenaiCorporation. 

gamolon. 

Menai Corporation 

1010 El Camino Real, Suite 370, Menlo Park, CA 94025 • info@menai.com 
VOX 415.617.5730 . FAX 415.853.6453 • BBS 415.617.5726 
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half of the pointer, the offset. However, once the offset 
reaches 0xFFFF, adding one to it returns it to zero, with a 
carry of 1. You cannot just add that 1 to the selector por¬ 
tion of the pointer, though. Instead, you have to add eight 
to the selector to obtain the correct new selector. In the 
more general case, if you added a large offset to a huge 
pointer, you would add the offset to the offset of the origi¬ 
nal pointer, then multiply any carry bits by eight, and add 
that to the selector. Instead of multiplying by eight, in as¬ 
sembly language you would probably left shift by three 
for efficiency. 

You can avoid hard-coding these aspects of tiled selec¬ 
tors (add eight, or left-shift by three) by using two ex¬ 
ported Windows variables. KERNEL (the Windows DLL re¬ 
sponsible for operating system functions) exports _AHINCR, 
an integer equal to 8, which is the amount to increment a 
huge pointer's selector when crossing a 64Kb boundary. 
KERNEL also exports _AHSHIFT, an integer equal to 3, which 
is the amount to left-shift a carry from the offset portion 
into the selector portion. When you use huge pointers in 
C, your compiler emits code to deal with huge pointer 
math that manipulates the selector portion of the address 
in units of _AHINCR. For example, given the following code 
fragment: 

char huge * foo; 
int ib; 
foo += ib; 


Listing 1 continued 


{ 

default: 

return: 

case SBJOTTOM: 
ilin = clinLim;. 
break: 

case $B_T0P: 
ilin * 0; 
break; 

case SB_LINEDOWN: 
ilin++; 
break: 

case SBJ.INEUP: 
ilin--; 
break: 

case SB.PAGEDOWN: 
ilin += clinRect; 
break; 

case SB.PAGEUP: 
ilin -* clinRect; 
break; 

) 


SetScrol 1 Posthwnd. SBJERT. ilin. TRUE); 
InvalidateRectihwnd. NULL, TRUE); 

} 

/* End of File */ 
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_ Telnet (VT100, VT220, TVI), TN3270, 
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with MIME, NewsReader, PROFS Mail, LPR/LPD, Gopher, Phonetag, 
Ping, Finger, BIND, Whols, Scripting, Statistics, Custom, TFTP, 
SNMP Agent, and more. 


TERMINAL EMULATION Advanced features include scalable fonts, 
scripting, button pad, screen capture, drag-and-drop keyboard 
remapping and printing. INTERNET ACCESS Easy point-and-click 
access to the resources of the Internet. Read and post to news 
groups, download software or documents and search gopher space. 
NFS First ever client and server for Windows provides transparent 
file and printer sharing (ask for Chameleon/VFS). MAIL Internet 
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the VC++ 1.5 compiler emits the following instructions: 


; foo = -4 
; ib = -6 

raov ax, WORD PTR [bp-6] ;ib 
cwd 

sub bx, bx 
mov cx, ax 

add WORD PTR [bp-4], cx ;foo 


adc bx, dx 

mov cx, OFFSET _AHSHIFT 

shl bx, cl 

add WORD PTR [bp-2], bx 


This is nine instructions; using far pointers, the following 
two instructions do the same work: 


mov ax, WORD PTR [bp-6] :ib 
add WORD PTR [bp-4], ax ;foo 


The overhead of huge 
pointer code is especially notice¬ 
able in tight loops indexing a 
huge array. As a result, most 
segmented code uses far point¬ 
ers instead of huge, but with 
the limitation of only being able 
to address 64Kb. This poses a 
problem if you have a chunk of 
data larger than 64Kb, but want 
to call a function that was com¬ 
piled with far pointers, not huge 
pointers. One 'solution' is to 
copy the memory from the cur¬ 
rent position in the huge block 
into a small (<64Kb) block, sup¬ 
ply this to the function, then 
copy the results back to the 
huge memory block. The obvi¬ 
ous problem here is that the 
data in the huge block ends up 
being copied twice. Another so¬ 
lution is possible, but to explain 
it, I first have to describe selec¬ 
tors and descriptors in a little 
more detail. 

Selectors and Descriptors 

Selectors (and descriptors) are 
actually only one layer in the 
three-level Intel memory archi¬ 
tecture. At the lowest level is 
physical memory. In enhanced 
mode, the Intel paging mecha¬ 
nism is used to map physical 
memory into linear memory, 
the second level. Linear mem¬ 
ory spans the entire 32-bit ad¬ 
dress space of 4Gb. Selectors 
and descriptors map linear 
memory into segmented mem¬ 
ory, the third level. Figure 2 pro¬ 
vides an approximate image of 
the relationship between se¬ 
lectors, linear memory, and 
physical memory. A seg¬ 
mented address, also known 
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WYSIWYG environment much 
like WinHelp. If you have 
manuals or documents, Help 
Magician Pro will import them 
from any popular Windows 
word processor and convert 
them to online help. You can 
simultaneously test your help 
files while working on them. 
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Because It’s So Powerful. 

Help Magician Pro has all the 
flexibility you’ve come to expect 
from a professional help 
authoring tool like support for 
ALL WinHelp 3.1 features, a 
fool-proof macro editor, 
multi-file project management, 
multimedia support, automatic 
glossary creation, and much 
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Actual Editing Environment 

Here’s The Scoop. 
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demonstrate that the Help 
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than any other help authoring 
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details and a FREE fully 
functional demo disk. The Help 
Magician Pro now includes the 
Help Compiler and SHED editor. 
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Sometimes you'll find you are 
held back by the limitations of 
using Visual Basic alone. 



We can only drop you a line, 
if you drop us one (1-800-35-BASIC). 


If you use Visual Basic because it allows 
you to create real, quality Windows appli¬ 
cations quickly with minimal effort, then 
you'll want to use Crescent Software's 
add-on tools for those same good reasons. 

We've been providing reliable software 
solutions to Basic programmers for nearly 
8 years, so we know what tools you need 
and how to deliver them to you. Plus, our 
products come with complete source code 
and example programs so you can learn 
how we write expert Visual Basic code. 

So, if you're ready, grab a hold of Crescent 
Software's Visual Basic product line, you'll 
like what you see at the top! 

"Few a professional programmer writing sophisticated, real world 
applications, QuickPak Professional is a treasure trove.' 

- Windows Magazine, 1993 

QuickPak Professional for Windows ($199) includes 30+ Custom 
Controls, 400+ DLL routines, 2.7 MB of sample code, 3+ MB of 
source code, 1,000 pages of documentation (2 separate volumes), 
and several time saving utilities for Visual Basic. With this kind 
of unprecedented power, you can quickly create show stopping 
Windows-based applications with ease! 

Most of the custom controls are data- 
aware. Included are masked edit controls, 
enhanced list box, and scroll bars, a cal¬ 
endar control, spin button, command 
button, and our unique form management 
control, and more! 

Separate common dialog controls are pro¬ 
vided that are easier to use and more 
powerful than those supplied with 
Microsoft’s Professional Toolkit. 

_ More than 400 DLL routines cover a 

broad spectrum of services including array searching multi-key 
array & file sorting (including huge arrays); file and directory 
services; string parsing searching and formatting financial and 
statistical functions; missing memory functions such as Peek, 

Poke, Inp, Out Cvx, Mkx, (including Mbf versions), VarSeg 
VarPtr, SSeg SAdd, InterruptX and much, much more. 
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Apex Software's Standard Edition bound grid control is now 
bundled with QuickPak Professional for Windows. A $69 Value 
FREE with every purchase! 




<r Visual Basic ($99) generates listings of all keywords, 
forms, controls, properties, events, methods, variables, arrays, 
constants, and procedures by type and scope - even across 
seperate modules. 

It automatically recognizes properties and events of custom 
controls, as well as all Visual Basic 3.0 data objects. A 
unique call-tree report identifies your procedures showing the 
the hierarchy of procedures that are pres¬ 
ent but never used, and it also gener¬ 
ates a formatted listing of your source 
code complete with headers, footers, and 
a table of contents. 




XRef for 
Visual Basic 


NetPak 

Professional 


» 



XRef can also extract quoted strings and/ 
or remarks from your source code and 
save them in a separate text file that 
can then be merged back into your pro¬ 
gram through most spell checkers. 
Corrected text can then be merged back 
into your program with the supplied utility program. 

Reports can be viewed with the built-in file browser or sent 
directly to your printer. XREF is an outstanding tool for doc¬ 
umenting and managing complex applications, and can save 
you hours of work. 

’The fact that less than 60 seconds are required to create 
a terminal emulator, suitable for communicating with most 
computers, is indicative of PDQComm's power.* 

- BASICPro Magazine, 1993 
PDQComm for Windows ($149) is based on the MSComm 
control that Crescent Software, Inc. wrote for Microsoft's 
Visual Basic Professional edition, and it adds several im¬ 
portant enhancements. 

Included are background file transfers 
using ZModem, YModem, XModem, 
CompuServeB+, or Kermit protocols, 
optional display of a status dialog box 
with a percent-complete meter, and TTY, 
ANSI, DEC VT100 and VT52 terminal 
emulations. All of these features are 
extremely easy to use - just add the 
PDQComm control to a form, set a few 
properties, and within 30 seconds you're 
dialing to your favorite on-line service! 

PDQComm for Windows also includes a 64K scroll-back buffer 
session logging and a complete set of Visual Basic routines 
for handling modems (including a database of commands for 
nearly 450 modems). Extensive documentation and examples 
are provided, C source code is also available. 


Professional for Windows ($179) provides seamless 
access to many NetBIOS, NetWare, and Windows for Work¬ 
groups network services. This product provides a compre¬ 
hensive collection of 100+ network functions that help the 
novice and professional programmer add advanced network 
capabilities to their programs written in Visual Basic. 

Services are included for Netware print and 
bindery functions; NetWare QMS functions; 
NetWare Connection functions; NetWare 
Workstation and File Server Environment 
functions; NetWare Message and Directory 
functions, NetWare TTS and 386 (F2) spec¬ 
ific functions; Windows Built-In functions; 
Windows for Workgoups functions and 
Miscellaneous Windows API functions. 






The combination of Visual Basic for Win¬ 
dows and NetPak Professional is the fastest 
way to write network-aware and network specific applications. 

NetPak Professional received the 1994 readers choice award 
by the readers of Fawcette Technical Publications Visual Basic 
Programmers journal. 


"Until recently, there has been no truly useful scientific pro¬ 
gramming toolbox for Visual Basic programmers. That's where 
QuickPak Scientific for Windows makes ifs grand entrance.* 

- BASICPro Magazine, 1993 

Each QuickPak Scientific for Windows ($149) routine offers a 
flexible and easy to use Basic-Language algorithm to help dev¬ 
elopers solve practical and challenging problems in engineering 
science, and other technical applications. Function categories 
include linear and matrix algebra, differential equations, non¬ 
linear equations, curve fitting fast Fourier transforms, numerical 
integration, and the especially challenging 
area of numerical optimization. 


QuickPak 

Scientific 
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There are also provisions for statistical 
computations, manipulation of complex 
numbers, advanced trigonometry functions, 
and vector mathematics. Utility programs 
and routines are included to perform cap¬ 
abilities with Julian dates and produce very 
attractive, yet simple, plots of functional 
data. Complete source code is included, 
along with comprehensive demonstration 
programs for each routine. 
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as a far address, is comprised of a 16-bit selector and 
either a 16- or 32-bit offset (Windows 3.1 typically ex¬ 
poses only 16-bit offsets). 

Some of the important fields in a selector's descriptor 
are the base address, limit, and granularity. The base ad¬ 
dress is a 32-bit linear memory address that is the first 
location addressable using the selector. To illustrate, sup¬ 
pose selector 0x080f references a descriptor whose base 
address is linear memory location 0x8066e000. Then the far 
address 080f:0000 references the same memory as the lin¬ 
ear address 0x8066e000. 

The descriptor's limit field determines the size of the 
memory block addressable from the selector (the proper 


term for this block is a segment - a segment is nothing 
more than a span of linear memory whose base and size 
are specified by the descriptor associated with the selector 
used to address the segment). The memory span specified 
by the limit field is added to the base field to determine 
the last addressable byte of the segment. The limit field is 
only 20 bits long, which would normally mean the largest 
segment is only 1Mb. This is where the granularity bit 
comes in. When the granularity bit is 0, the units of the 
limit field are bytes, but when it is 1, the units are 4096- 
byte blocks (pages). So it is possible to span all of linear 
memory with a selector whose descriptor has page 
granularity. 

When a selector is loaded into 
one of the segment registers (CS, DS, 
55, ES, FS or 55), the corresponding de¬ 
scriptor is loaded into a hidden 
'shadow' register. This register is not 
accessible to the programmer, but is 
necessary for quick access to the de¬ 
scriptor's fields, allowing the hard¬ 
ware to avoid constantly having to 
perform lookups in the descriptor ta¬ 
ble. Many programmers talk about a 
descriptor's properties as if they were 
properties of the selector. This short¬ 
hand saves having to repeat phrases 
like 'the selector's descriptor's fields' 
and I will use it in the text that fol¬ 
lows. 

Manipulating Selectors 

The basic idea, then, is to con¬ 
struct pointers that refer to any 64Kb 
portion of a huge memory segment 
by conducting a selector that refer¬ 
ences that memory. You can then 
pass this selector to any function that 
uses far rather than near pointers, 
have it process that data, form a new 
selector to point to another chunk, 
call the function again, and so on. 
This requires the ability to construct a 
selector that refers to an arbitrary 
chunk of memory. 

In theory, the Windows selector 
API functions AllocSelectorO, FreeSe- 
lectorO, GetSelectorBaseO, SetSelec- 
torBaseO and SetSelectorLimitO 
should provide all the functionality 
needed to implement far pointer ma¬ 
nipulation of a huge block of mem¬ 
ory. But in reality, their implementa¬ 
tions have problems that caused me 
to avoid using them. For more details 
on the problems with these functions, 
see the 'Windows Bug of the Month' 
(page 58) in this issue. 


Vexed by I fxDs?... 
Help is Here! 


"Until now, VxD writing 
has been for wizards only. 
VtoolsD hides the complexity with 
a clean high-level interface ." 

— Ten Schiele, Progra m Manager 
Microsoft Windows SDK & DDK 


VtoolsD for Windows 3.1 is a comprehensive 
toolkit that brings VxD development out of 
the dark ages of assembly language into the 
age of C, C++, and visual programming. 

You’ve needed a Virtual Device Driver to squeeze 
more performance out of Windows; to build interfaces between Windows 
and DOS programs; to support custom hardware; in short, to push Windows 
to its limits. 

Now enter the realm of Windows system programming equipped with tools 
that leverage your expertise in high level languages. VtoolsD was designed 
explicitly for C and C++ programmers. You can build great VxDs without 
writing one line of assembly language. Build your next VxD in C or C++ 
with VtoolsD for Windows 3.1. 


VtoolsD includes: 

■ Optimized C-callable VMM/VxD 
service libraries 

■ The only Class Library for VxD 
programming 

■ Customized ANSI C Run Time 
Library coded specifically for 
VxDs 

■ Complete library sources 

■ Full support for Microsoft Visual 
C++ 32-bit Edition 

■ Documentation for all interfaces 
and classes 

Plus: QuickVxD " — a visual 

programming code generator for 

fast starts on new VxD projects. 


VtoolsD and QuickVxD are trademarks of Vireo Software, Inc. 
All other names are trademarks of their respective holders. 
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30 day mmeyback guarantee 
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If Einstein had to make the choice he'd 
probably take a " hands-on" Object-Oriented 
C++ course for MFC, OWL and OLE from 

Leading Design! 


Experience and Learn 
Object-Oriented C++ with 
MFC* or OWL! 


DAS 1ST 

Object computing is rapidly V WUNDERBAR! 
becoming the technique of choice 
for most major software developers. 

Today, 60% of Windows applications 
use objects. Tomorrow, Taligent, 

Chicago, Cairo, CORBA, SOM. Object 
Databases, enterprise computing with 
and without OLE wait for the unsuspect¬ 
ing programmer, all with new kinds of 
objects and "paradigms" in tow. 


Powerful Courses for 
Powerful Results 

To use objects most effectively, 
you must approach software develop¬ 
ment in a whole new way. Not only 
must you learn the syntax and features 
of your object language and develop¬ 
ment system, but you must think in 
an object-oriented way. 



NEW COURSE 
OLE 2 in 3 days. Build an OLE 2 
container and server. 

Call for Details! 


That is where Leading Design, the 
premier software consulting and training 
firm specializing in object technology, 
comes in. We have unparalleled 
experience training software develop¬ 
ment teams, ranging from Fortune 100 
companies to small businesses, in object 
technology and C++. 


Cut Your Object Learning 
Curve With Intensive 
Hands-On Training! 

Object-oriented C+ + using Microsoft 
Foundation Classes or Borlands Object 

Windows Library spans five full days 
with four hours of instruction and four 
hours of intensive, hands-on labs every 
day. Participants will learn how to 
design and code industrial strength C++ 
Windows applications using MFC/OWL 
and the tools of Microsoft Visual C++ 
or Borland IDE depending on the course 
you select. 

Our training, mentoring and consulting 
customers include IBM, Microsoft, NCR, HP, 

TI, Wang Labs, Xerox, Intel, Pan Canadian 
Petroleum, Aldus, NEC, Word Perfect, Safeco, 
Chevron, Symantec and Boston University. 


Register Early! Call for Discounts! 1-800-355-9845 


5-DAY COURSE TOPICS INCLUDE: 


✓ Effective coding techniques to maximize the benefit of MFC or OWL classes 

✓ Practical methods to design object-oriented Windows applications efficiently 

✓ Strengths and weaknesses of key C++ features to avoid traps and blind alleys 

✓ Scaleable C++ coding procedures that are safe, reusable and easy to maintain 


Our 3 or 5 Day Courses 
Are Designed For: 


C and C++ programmers 

migrating towards Windows 
Programmers using C to 
develop Windows applications 
Developers involved in object- 
oriented Windows programming 
seeking a second opinion on key 
technology decisions 
Software designers and 
architects needing to understand 
object-oriented Windows 
OOA, OOD, OOP and OLE 2 
Technical managers responsible 
for hands-on object-oriented 
Windows software development 
and strategic direction 


LEADING DESIGN 
COURSES INCLUDE: 

Building a full scale 
application in 10-16 labs 
using C++, MFC or OWL 
and a valuable Object 
library. Plus, course 
software and manual. 



MONTHLY COURSES: 


■ SEATTLE ■ CHICAGO ■ BOSTON 

Please contact Vicky Lindgren for exact dates and locations. 
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Figure 1 Sequential selectors allocated by Windows 


Local Descriptor Table 
(LDT) 

Offset 



function number placed in the AX reg¬ 
ister. I will quickly run through these 
functions and their arguments. 

Function 0 allocates a selector 
from a pool of LDT selectors, but un¬ 
like GlobalAllocO, does not also allo¬ 
cate memory, and unlike AllocSelec- 
tor(), does not allocate a whole 
mess of them behind your back. You 
call it, specifying in CX the number of 
LDT selectors you want to allocate: 


mov 

ax,0000h 

Function 0 

mov 

cx,l 

Only want one selector 

int 

31h 

Call DPMI 

mov 

sel,ax 

selector is in AX 


Function 1 releases a selector (and 
only one selector) back to the LDT 
selector pool. You supply the selector 
to be freed in BX: 

mov ax,O001h ; Function 1 

mov bx.sel ; Selector -> BX 

int 31h ; Call DPMI 


Instead of using the Windows selector functions, I used 

the lower-level DPMI functions 0, 1, 6, 7, 8, and 9. DPMI Function 6 returns the 32-bit linear base address field 
functions are invoked by invoking an int 31h, with the of the selector. You specify the selector in BX and the 32- 

bit address returns in CX-.DX : 



With color reduction 
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24-bit image display 


Processing Library 

Create Powerful Image Applications 

for BMP, TIFF, PCX, GIF, TGA, and JPEG Images 

► 

► 


Load and save 

BMP/TIFF/PCX/GIF/TGA/JPEG 

Powerful grayscale and color 
image processing: brightness, 
contrast, sharpen, outline, 
equalize, matrix convolution, 
rotate, resize, and more 

Color reduction for fast and 
accurate display of 24-bit images 

Support for EGA/VGA/SVGA, 32K- 
and 16 million-color displays 

Scan b/w, grayscale, and color 
images with ScanJet scanners 

§► Print halftones, diffusion scatters, 
and color pictures 

Convert images between 1-, 8-, 
and 24-bit formats 

Convert color to grayscale 

Includes a complete image 
processing application with C 
source 



Your Windows application can load and 
save BMP TIFF, PCX, GIF, TGA, and JPEG 
files, control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 


Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
for DOS, supports Microsoft 
and Borland C/C++ compilers, $195 
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470 Belleview St Louis MO 63119 

314-962-7833 
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mov ax,0006h ; Function 6 

mov bx.sel ; Selector -> BX 

int 31h ; Call DPMI 

mov upper,cx 

mov lower,dx 

You can use Function 7 to set the 32-bit linear base 
address field of a selector, by specifying the selector in BX 
and the address in CXtDX: 

mov ax,0007h ; Function 7 

mov bx.sel ; Selector -> BX 

mov cx,upper 

mov dx,lower ; addr->CX:DX 

int 31h ; Call DPMI 

Function 9 sets the access rights and type for a given 
selector. These consist of several bit fields, for a total of 
16 bits. I use the constant 00F3h to set these bits; that sets 
up everything I need to access a 16-bit, ring 3 data seg¬ 
ment: 

mov ax,0009h ; Function 9 

mov bx.sel ; Selector -> BX 

mov cx.00F3h ; access/type bits 

int 31h ; Call DPMI 

; carry set if error 
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Function 8 is like function 7, except that it sets the limit 
field (the total size of the segment being addressed) 
rather than the base address field. You pass in the 32-bit 
limit CX:DX. if the limit specifies a block of memory greater 
than 1 Mb, then the lower 12 bits must all be set. 

All the pieces needed to implement the very simple far 
pointer creation technique have now been described. 
Given an arbitrary location in a huge block of memory, 
you obtain the selector's linear memory address with 
DPMI function 6, and add the offset of the location from 
the start of the huge block. This is the location's linear 
address. Next you allocate a selector by calling DPMI func¬ 
tion 0. Set the new selector's access rights and type to 
00F3h with function 9, and its limit to, 
say, OxFFFF (since the function you 
are calling cannot address more than 
64Kb from the start of its far pointer) 
with function 8. Set the selector's 
base address to the linear address 
you just computed (function 7). You 
can do this iteratively to process all 
the memory in the huge block. 

Demonstration Code 

contents.c (Listing 1) contains a 
small program to demonstrate the 
technique. This program reads the 
entire contents of a text file (the file 
can be greater than 64Kb but, for 
simplicity of implementation, is re¬ 
stricted to 16382 lines) into memory, 
and displays the text in a scrollable 
window (see Figure 3). To keep its 
source readable, I have omitted error 
checking, contents.exe uses the selec¬ 
tor mapping technique in two places: 
to count the number of lines in the 
file, and to display the visible portion 
of the text in the client area of the 
main (only) window. 

The file provides cover functions 
for the DMPI interrupts. SelAllocO al¬ 
locates a selector, sets its access 
rights and type to correspond to a 
16-bit Windows LDT data selector, 
and sets the limit field from the sin¬ 
gle ibLim parameter. SetBaseSellbO 
sets the base address of the given se¬ 
lector to the given value. IbBaseGet- 
Sel() returns a selector's base ad¬ 
dress. FreeSelO frees a selector allo¬ 
cated by SelAllocO. 

In order to quickly locate a par¬ 
ticular line of text (corresponding to 
the scroll position), an array of offsets 
into the text's huge memory buffer is 
created when the text is read into 
memory. ReadTextO is responsible for 
this chore. ReadTextO obtains the file 


name from the common dialog's GetOpenFileNameO routine 
and reads the file into memory. Just before allocating the 
selector, it calls GlobalFixO on the huge text buffer. This 
API function locks a segment at its current linear memory 
address. This prevents the global memory manager from 
moving the block (such as when it defragments linear 
memory). It would be catastrophic for the memory man¬ 
ager to move the block while the allocated selector is be¬ 
ing used to access the linear memory of the huge mem¬ 
ory buffer, since Windows does not automatically update 
selectors to track such changes. 

It is not strictly necessary for ReadTextO to call Global¬ 
FixO, since ReadTextO will not yield to nor call any API 
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functions that can allocate memory. 

But in general this is a step you 
should take when manipulating a se¬ 
lector's linear memory fields. It's also 
important to remember to unlock the 
huge block to prevent sandbars in 
linear memory (which impair the 
global memory manager's ability to 
do its job). 

ReadTextO then sets the selector's 
limit to 0xffff, enabling it to refer¬ 
ence an entire 64Kb block of mem¬ 
ory. It falls into a loop whose job it is 
to recognize new lines by checking 
for a newline carriage-return combi¬ 
nation or for a line that exceeds 
64Kb in length. The loop uses a far 
pointer created from the allocated se¬ 
lector to examine each character in 
the huge block. Each time a new line 
is found, a new entry is added to the 
text buffer offset map, and the selec¬ 
tor's base is reset to the linear mem¬ 
ory address of the current position in 
the huge text buffer. The far pointer 
must therefore be reset to the start of 
the new segment. 

Before returning, ReadTextO frees the allocated selector 
and unfixes the huge memory block. Even though 


ReadTextO 's selector manipulation is not done in support 
of calling a far pointer routine, it does result in a speedup 
of about 10% over the use of a huge pointer. 
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Figure 3 Demonstration of far access to huge 
memory 


PaintTextO, the routine responsible for handling 
UM_PAINT messages received by the main window, employs 
the technique so that ExtTextOutO can be used to display 
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a line of text from anywhere in the huge text block 
(ExtTextOutO can only display strings less than 64Kb since 
the strings are passed as far pointers). Just as ReadTextO 
did, PaintTextO fixes the huge block in linear memory, al¬ 
locates a selector, and sets the selector's limit to Sxffff. It 
then obtains the current scroll position, and uses it to in¬ 
dex into the text offset array to obtain the linear memory 
address of the first line to display. A far pointer is con¬ 
structed from the allocated selector. Its offset is set to 0 so 
that the pointer is addressing from the selector's base ad¬ 
dress. 

PaintTextO then falls into a loop that iterates over each 
visible line, calling ExtTextOutO to display the correspond¬ 
ing line of text. On each pass through the loop, the selec¬ 
tor's base address is updated to the next line of text, so 
the far pointer does not have to be updated; it is left 
pointing to the first byte of the segment (since the seg¬ 
ment itself is being slid over the huge block's address 
space). 

That's it for the neat stuff. The window procedure, 
LwUndProcO, preallocates memory for the text buffer offset 
array and text buffer when it is created. The pointers are 
stored in extra window bytes, set aside when the window 
was registered. When the window is scrolled, it calls the 
utility routine ScrollTextO to determine the amount to 
scroll by, and to adjust the position of the scrollbar's 
thumb accordingly. ScrollTextO then simply invalidates 
the client area and relies on the window's handling of the 
resulting UMJAINT message to display 
the text at the new position. The re¬ 
sult is a very fiickery display, espe¬ 
cially when you are scrolling by just 
one line. To prevent this, you would 
normally call ScrollDCO or ScrollUin- 
dowO and then update the uncovered 
line, but the goal here was to keep 
the code simple. 
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Memory Management 


Mastering DOS Real-Mode 
Memory 

Brian Sawert 
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Visual C++ vl .5 

j Borland C++ v4.0 
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Like it or not, some of us still program for DOS in real mode. We envy the 
vast expanses of memory provided by DOS extenders or Windows, but we 
know that what we do, we must do in 640Kb or less. Making the best use of 
this cramped address space means knowing how DOS doles out its precious 
resources. It means understanding the Memory Control Block (MCB), the key to 
the DOS memory allocation scheme. 

When DOS allocates real-mode memory, it builds a 16-byte header at the 
start of the allocated block. This header, the MCB, contains the size of the block 
and the owner. It may also contain information about the purpose of the mem¬ 
ory block or the name of the program that allocated it. DOS builds a chain of 
these structures, and the chain forms a record of system memory use. This 
information can be used as a tool for identifying system memory use and 
configuration, or for implementing memory swapping algorithms. In either 
case, it gives you extra control over how your program interacts with DOS. 

Figure 1 shows the structure of a normal MCB. Each MCB contains an identi¬ 
fier byte that indicates how the memory is used. Most blocks contain the letter 
'M', which indicates that other blocks follow them in the allocation chain. The 
last block in the chain holds the letter "T. 

The owner ID field contains the Program Segment Prefix (PSP) of the pro¬ 
gram to which this memory belongs. When a program terminates, DOS uses 
this field to identify which blocks to free. DOS sets the owner field in its own 
blocks to the number 8. Free blocks are marked with the number 0. 

The size field indicates the size in paragraphs of the allocated block, not 
including the extra paragraph for the MCB. To locate the next MCB in the 
chain, just add the size to the segment address of the current MCB and incre¬ 
ment it by one. 


Brian Sawert is an independent programmer and consultant who specializes in DOS 
device drivers, Windows applications, and software for SCSI peripherals. Please address 
any questions or comments to him at bsawert@grdpnt.fiagstaff.az.uz. or on Com¬ 
puServe at 72027,2243. 
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Listing 1 findtsr.c — Using the MCB chain to locate TSRs 

/* FINDTSR.C - Search for loaded TSR in memory. */ 

{ 

int umbjink, umb_stat, f_umb; /* upper memory flags */ 

//include <stdio.h> 


unsigned tsr seg; /* segment of loaded TSR */ 

#include <stdlib.h> 


char tsr_name[NAME_LEN + 1]; /* TSR name */ 

int exitval = 1; /* default to error exit */ 

#include "mcb.h" 


if (argc < 2) 

char usage[] » "Usage: findtsr <TSR name>\n"; 


{ /* no command line args */ 

fputs(usage, stderr); /* print usage message */ 

void maintint argc. char *argv[]) 


} 
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The owner name field is used in 
DOS versions 4.0 and later, in the 
first block allocated by a program, 
this field contains the program name, 
Mi-terminated if it is less than eight 
letters. If the owner ID field is the 
segment address of the segment just 
past the MCB, then the owner name 
field is valid. 

To follow the MCB chain through 
memory, you need to know where it 
starts. Since the authors of DOS did 
not intend for users to access the 
MCB chain directly, there are no 
documented calls for this. However, 
as with many useful DOS features, 
there is an undocumented method. 
Function 52h returns the address of 
the DOS 'List of Lists'. The word just 
preceding this address is the segment 
of the first MCB. This has remained 
constant since version 3, and is not 
likely to change in the future. 

Putting MCBs to Use 

The information the MCB provides 
may be interesting, but how can you 
put it to practical use? Suppose you 
need to know if a certain memory- 
resident program is loaded. Most TSR 
programs leave a stub that occupies 
a block in the allocation chain. This 
stub contains the program PSP, so its 
MCB contains the program name. To 
locate it, you just follow the alloca¬ 
tion chain, look for valid name fields, 
and compare them to the program 
name, findtsr.c (Listing 1) illustrates 
this process. It uses the utility rou¬ 
tines found in mcb.h (Listing 2) and 
mcb. c (Listing 3). 

The same concept applies to locat¬ 
ing device drivers, although DOS 
handles them a bit differently. The 
signature byte in a system MCB (the 
first byte) contains a letter indicating 
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Listing 1 continued 

else 

{ /* got argument */ 

umbjink = get_umbjink(); /* get link status */ 

umb_stat = set_umb_link( umbjink); 
f_umb * (umb_stat == 0) ? 1 : 0: 

tsr_seg = get_tsr_seg(argv[l], f_umb ) ; 

if (tsr seg 1= 0) 

{ /* found TSR */ 

mem_owner_name(tsr_seg - 1. tsr_name); 
printfCHs found at segment *04Xh. \n", 

tsr_name. tsr_seg); 
exitval - 0; /* success exit */ 

1 

1 

exit(exitval): 

1 

/* End of File */ 


its use. For device drivers, DOS uses 
"D'. Other letters correspond to op¬ 
tions set in config.sys, as shown in 
Figure 2. You won't normally see 
these identifiers in the allocation 
chain, because DOS splits up larger 
blocks of memory for system data. 
The larger blocks, marked with 'SD' 
in the name field, are suballocated 
using the same method as the main 
allocation chain. The paragraph im¬ 
mediately after an 'SD' block is the 
first MCB in a system subchain. The 
last entry in this smaller chain points 
to the same MCB as the 'SD' block. 

Device drivers appear in these 
subchains with the MCB name field 
set to the name of the driver file 
name and padded with blanks to 
eight spaces. The driver filename is 
not always the same as the device 
name in the driver header for charac¬ 
ter devices. For instance, the file 
himem.sys installs a device named 
'XMSXXXXO'. The MCB contains the 
string 'HIMEM', and the driver header 
in the next paragraph contains 
'XMSXXXXO'. Drivers from different 
manufacturers may install the same 
device, but the file name can vary. 
This offers programmers a tool to 
identify drivers with known problems 
or enhanced features. 

To locate a driver, search the 
suballocation chain for 'D' identifiers. 
This method differs from following 
the actual device driver chain, be¬ 
cause it only locates installable de¬ 
vices. System devices like NULL, LPT, 
and COM do not allocate this mem¬ 
ory. 

What about upper memory? What 
happens when devices or programs 
are loaded high? When no upper 
memory is available, the last MCB, 
marked with ‘T, points to segment 
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Figure 1 The Memory Control Block (MCB) 
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In DOS 4.0 or better, 
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- ’M’ (4Dh) == valid block 
’Z’ (5Ah) == last block 


A000h. If DOS controls upper memory, this MCB is still 
marked with 'Z' but points to 9FFFh. The MCB at 9FFFh, 
named 'SC' for system code, points to the first upper 
memory block. The upper memory allocation chain con¬ 


tinues, using 'SC' blocks to skip over 
excluded upper memory and adapter 
space. 

If you're curious about how DOS 
manages chunks of upper memory, 
look at the paragraph preceding the 
first upper MCB. You'll see the owner 
name, 'UMB'. This is a control block 
for the suballocation chain DOS uses 
to parcel out upper memory. Just as 
the 'SD' blocks are divided into 
smaller chunks, the 'UMB' blocks are 
cut up to provide upper memory. 
You won't usually encounter the 
'UMB' control blocks, since the upper 
memory allocation chain points 
around them. 

If the last block in the lower mem¬ 
ory chain is marked 'Z', how do you 
know when the chain continues into 
upper memory? DOS versions since 
5.0 provide the capability to link 
lower and upper memory. Function 
58h controls the memory allocation 
strategy. Subfunction 02h returns the upper memory link 
status, and subfunction 03h sets it. If no upper memory is 
available, setting the link status will fail, returning an error 
code indicating the call was not valid. 
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Listing 2 mcb.h — Interface to MCB functions 


/* mcb.h - MCB constant/structure/function declarations */ 
/* check for multiple Inclusion */ 


Dfndef _MCB_H 
(define .MCB.H 


defines and macros 


(define NAME.LEN 


(define ERR.INVALID 
(define ERR.BADARENA 


8 /* length of name field */ 

1 /* invalid func (non-DOS UMB) */ 

7 /* memory arena corrupt */ 


typedef struct tagMCB 
( 

char mtype; 
unsigned owner; 
unsigned size: 
char reserved[3]; 
char name[NAME_L£N]; 
} MCB; 


/* memory control block structure */ 
/* memory block type identifier */ 
/* PSP of owner */ 
/* memory block size */ 

/* owner name if valid */ 


external routines 


/* get base of allocation chain */ 
unsigned get.base.segCvoid): 

/* get next block in chain */ 

unsigned get_next_seg(unsigned seg. int f.umb); 

/* get block owner name */ 

int mem.owner.nametunsigned seg, char *pname); 

/* get TSR arena segment */ 

unsigned get_tsr_seg(char *pname, int f.umb); 

/* get upper memory link status */ 
int get.umbjinktvold); 

/* set upper memory link */ 
int set.umb.linktint f.link); 

(endif 

/* End of File */ 
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Memory Swapping 

Probably the most powerful use a programmer can 
make of MCB information is to implement memory swap¬ 
ping. Memory swapping can help open up the cramped 


Listing 3 MCB utility functions 


/* mcb.c - routines to manage DOS Memory Control Blocks */ 

(include <dos.h> 

(include <string.h> 

(include "mcb.h” 

/*.-.- defines and macros .*/ 

(define FUNC.LIST 0x5200 /* Get List of Lists */ 

(define FUNCJJMB.STAT 0x5802 /* get UMB link status */ 

(define FUNC.UMB.LINK 0x5803 /* get link UMB */ 

/* . 

Routine to get base segment of allocation chain. 

Usage; unsigned get.ba se.seg(void): 

Called with nothing. 

Returns segment of first MCB. 0 on error. 
. —*/ 

unsigned get.base.seg(void) 

( 

union REGS params; 
struct SREGS segregs; 
unsigned far *segptr; 
unsigned retval = 0; 

params.x.ax * FUNC.LIST; 

intdosxdparams, iparams, tsegregs); 

if (params.x.cflag = 0) 

( /* call succeeded */ 

/* point to word before List */ 
segptr = (unsigned far *) 

MK_FPtsegregs.es, params.x.bx - 2); 

retval = *segptr; 

) 

return(retval); 

} 

/*. 

Routine to get next segment in allocation chain. 

Usage; unsigned get.next.seglunsigned seg, int f.umb); 

Called with current segment, flag to include upper memory. 
Returns segment of next MCB in chain, 0 if last MCB. 
.-*/ 

unsigned get_next_seg(unsigned seg, int f.umb) 

( 

MCB far *lpmcb; 
unsigned next.seg = 0: 

lpmcb = (MCB far *) MK_FP(seg, 0); /* point to MCB */ 

if (lpmcb->mtype != 'V 11 (seg < 0xa000 1A f.umb)) 

{ /* intermediate link in chain */ 

next.seg * seg + lpmcb->s1ze + 1; 

} 

return(next.seg); 

} 


/*. . . 

Routine to get MCB owner name 

Usage: int mem.owner.nametunsigned seg, char *pname); 

Called with MCB segment, pointer to name buffer. 

Returns name length on success, 0 on failure. 
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confines of the 640Kb of lower memory DOS provides. 
The concept of swapping is simple - a program saves 
portions of itself to disk or elsewhere, making memory 
available for other purposes. A small program stub reloads 


these portions when needed. Swapping is especially help¬ 
ful in the case where an application must spawn another 
program, or run command, com to let the user access DOS. 


Listing 3 continued 


■*/ 


Int mem_owner_name(unsigned seg, char *pname) 

( 

MCB far *lpmcb; /* pointer to MCB */ 

char nbuff[NAME_LEN + 1]; 

memsetlnbuff, 8, slzeoftnbuff)): /* clear buffer */ 

lpmcb = (MCB far *) MK_FP(seg, «); /* point to MCB */ 

If (lpmcb->owner == seg + 1) 

{ /* first program block - valid name */ 

_fstrncpy((char far *) nbuff. lpmcb->name, NAME_LEN): 
) 

strcpy(pname, nbuff); /* copy from local buffer */ 
returnC strlen(pname)); 

1 

/*. 

Routine to find TSR In memory. 

Usage: unsigned get_tsr_seg(char *pname, int f_umb); 

Call/w pointer to TSR name/flag for upper memory search. 
Returns TSR segment on success. 8 on failure. 

.*/ 


unsigned get_tsr_seg(char *pname, Int f_umb) 

{ 

char buff[NAME_LEN + 1]; 
unsigned seg; 
unsigned retval = 8; 

seg * get_base_seg(); /* get base segment */ 

while (seg 1= 8) 

( /* got legal value - continue */ 

if (mem_owner_name(seg, buff) 1= 8) 

( /* got valid owner name */ 

If (stricmp(buff, pname) = 8) 

{ /* case Insensitive match */ 

retval = seg + 1: /* TSR found */ 

break; 

) 

} 

seg = get_next_seg(seg, f_umb);/* get next header */ 
) 

return(retval); 

) 

/*. 

Routine to get status of DOS upper memory link. 

Usage; int get_umb_l 1nk(void): 

Called with nothing. 

Returns 1 If upper memory linked, 8 otherwise. 

. . */ 


Int get_umb_lInk(vold) 

( 

union REGS params: 

Int retval; 

params.x.ax = FUNC_UMB_STAT; I* get upper memory link */ 
intdosl&params, Jparams): 

retval = (int) params.h.al: /* return link status */ 

return(retval); 

} 


/*. 

Routine to set DOS upper memory link status. 

Usage; Int set_umbJ1nk(1nt fjlnk); 

Called with flag to link or unlink; 

Returns 8 on success, DOS error code on failure. 

.*/ 


Int set_umbJ1nk(1nt f link) 

( 

union REGS params; 

Int retval; 

params.x.ax = FUNC_UMB_LINK; /* set upper memory link */ 
params.x.bx = (fjlnk) ? 1 ; 8: /* set link flag */ 

IntdosUparams, Iparams): 

retval = (params.x.cflag = 8) ? 8 : params.x.ax; 

return(retval); 

) 

/* End of File */ 
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the PSP to the end of lower memory belong to your pro¬ 
gram. 

The MCB offers a way to locate these program blocks. 
Each one contains the PSP in the owner field. You can 
follow the allocation chain starting with the PSP block, 
checking the owner field as you go. For each block you 
wish to swap, read the size field in the MCB, write the 
block to storage, and set the owner field to 0 to mark it 
free. 

To reduce the program footprint even further, you can 
reduce the size of the PSP block. This requires extra care 
and some advance preparation in laying out the program 
code. The reload stub must reside close to the start of the 
program code, since you will discard as much of the tail 
as possible. This means swapping out the program stack 
and heap, so the stub must contain its own data. Writing 
the stub in assembler makes it possible to combine code 
and data segments, making the stub as self-contained as 
possible. Listing the reload stub at the beginning of the 
object modules in the linker command line will generally 
place it near the beginning of the program code. 

You may be discarding live code, so you need some 
extra steps to protect system integrity. If your program in¬ 
stalled interrupt handlers or mouse callback routines, you 
must disable these if you plan to swap the code out. Any 
buffers your program allocated for DOS use must reside 
where they won't be discarded. For example, the DOS 
Disk Transfer Area (DTA) may reside in your program 
heap instead of the PSP. A healthy dose of paranoia helps 
when examining the code. 

The sample code in memswap.asm (available on the code 
disk - see Contents page for availability) contains a reload 
stub written in assembler. It splits the PSP block and dis¬ 
cards all the code beyond a defined cutoff point, writing 
each MCB and its block to disk. If the environment seg¬ 
ment follows the PSP in memory, the stub copies the envi¬ 
ronment to the program tail and changes the segment 
value in the PSP so the old environment block can be 
discarded. It then spawns a child process that has access 
to the newly freed memory. On return, the stub reads in 
each block, rebuilding the allocation chain as it goes. No¬ 
tice that this example does not perform all the checks 
mentioned above. 

It helps to know something about the program you 
spawn using this method. If the child program installs in¬ 
terrupt handlers, it is a good idea to save a copy of the 
vector table, restoring it when the child program returns. If 
you spawn command, com, the user may try to install a mem¬ 
ory-resident program. Be paranoid again in trying to an¬ 
ticipate the possibilities. 

Summary 

This article should give you an overview of how DOS 
uses Memory Control Blocks to manage its resources. It 
should also give you some idea of the information you 
can extract from MCBs and how you can use them to en¬ 
hance your programming. Working under DOS real mode 
limits the memory available, but it doesn't limit your possi¬ 
bilities. □ 
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Figure 2 System MCB Identifiers 

Identifier 

Description 

D 

Device Driver 

E 

Device Driver Appendage 

B 

Buffer Memory 

C 

Buffer EMS Workspace 

F 

Files Memory 

X 

FCB Memory 

L 

Lastdrive Memory 

S 

Stack Memory 

1 

IFS Driver 


A running program normally has at least two blocks 
allocated. The program environment resides in one block, 
and the program itself resides in the PSP block. Any DOS 
allocation the program performs creates more memory 
blocks. Some compilers may allocate buffer memory for 
functions such as printfO or fopenO. Functions that set 
environment variables may also reallocate a larger envi¬ 
ronment block. If this memory comes from the DOS global 
heap instead of the program heap, it creates more blocks. 
In a typical situation, all allocated memory blocks from 
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Windows Multimedia, Part 4 
Audio Special Effects: 

Echo and Reverb 

Charles Mirho 


Overview 

Acoustics is the science of sound. Acoustics attempts to model what people 
hear when a sound occurs in different environments. For example, a bouncing 
basketball sounds quite different on an indoor hardwood floor than outside on 
the asphalt. Much of this difference in sound is due to echo effects. In this 
article I examine how signal processing can be applied to create echo and 
reverb effects in WAV audio files. 

Sound is energy that travels through the air and strikes the ear. Echoes are 
caused by reflections of sound waves. Sound radiates in many directions from 
its source, striking not only the ear but any other objects in the vicinity. Reflec¬ 
tions from these objects strike the ear slightly later than the original sound, 
creating echo. 

The sounds we typically hear consist of a primary sound mixed with reflec¬ 
tions. Sound created in closed spaces with hard walls contains the most reflec¬ 
tions. Examples include hallways, stairwells, concert halls, and cheap confer¬ 
ence rooms. When a person speaks, his/her voice is reflected from the sur¬ 
rounding objects, and these reflections mix at the ear. Figure 1 demonstrates 
this process for a single reflection. 

Diagrams called signal flow diagrams are used to model the flow of sound 
energy. These diagrams capture not only information about flow but also 
propagation delays and gains. Figure 2 shows a simple signal flow diagram, the 
key parts of which are the input, output, delay, summation, and gain symbols. 
The input is simply the original sound. The output is what people hear. The 
delay quantifies the propagation delay of a reflection. The summation indicates 
a mixing of two energies, and the gain indicates attenuation in the reflections 
and original sound. Because of their similarity to electrical circuits, signal flow 
diagrams are sometimes called circuit diagrams. 



Charles Mirho is a consultant specializing in Multimedia and Telephony. He holds a 
Master's degree in Computer Engineering from Rutgers University. He can be reached 
on CompuServe at: 70563,2671. 
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Creating echo in WAV files re¬ 
quires digital signal processing (DSP). 
DSP is the science of manipulating 
digital series that represent real-world 
phenomenon. DSP is mathematical in 
nature, as suggested by the mixing, 
delay, and gain symbols in Figure 2, 
so an understanding of DSP in C (the 
language used in this article) includes 
knowledge of how computers do 
math. Optimizations for precision and 
speed are possible using floating- 
and fixed-point arithmetic, long inte¬ 
gers, the modulo operator, and the 
left and right shift operator. Ad¬ 
vanced DSP requires theory and 
math upon which entire curriculums 
are built; in this article, I only scratch 
the surface. 

Echo and Reverb Concepts 

The diagram in Figure 1 shows 
that sound energy flows directly from 
source to listener over path a-b, while 
a reflection flows from source to ob¬ 
ject to listener over path a-c-b. The 
reflection travels farther, hence 
reaches the ear later, than the origi¬ 
nal sound. A delay symbol is built 
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into a-c-b to quantify this delay. The delay is stated in 
samples, that is, how many samples of the sound could 
be taken during the delay between the sound and the 
echo. The reflection loses energy when it strikes the ob¬ 
ject, and this loss of energy makes it sound weaker. The 
gain should be less than unity for attenuation, or weaken¬ 
ing, of the reflection. For the rest of the article, I will use 
the terms gain and attenuation interchangeably. 

A more complicated echo model is one in which en¬ 
ergy reenters the system. In this case the initial sound 
bounces around for some time before fading away. The 
ear is bombarded not only by the primary sound, but also 
by reflections and reflections of re¬ 
flections. Energy eventually leaves 
the system, but only after recirculat¬ 
ing many times. Rooms and closed 
spaces in general have this property. 

Figure 3 models the energy flow of a 
single sound and reflection repeatedly 
attenuated and fed back into the system. 

This is commonly known as reverbera¬ 
tion. 

Of course, single-reflection envi¬ 
ronments are rare. What the circuits 
actually represent are the building 
blocks of more complex systems with 
more reflections that model reality. 

(More complex systems and their 
models are beyond the scope of this 
article). From these circuits a mathe¬ 
matical equation of the system may 
be derived. For the circuit in Figure 2, 
the output can be expressed in terms 
of the input as 

Equation 1. y(t) = gl*x(t) + g2*x(t-T) 

where y(t) is the output at a particular 
time, x(t) is the input at a particular 
time, x(t-T) is the input delayed by T 
units of time (the reflection), and gl 
and g2 are the gains (attenuation) of 
the sound and reflection, respectively. 

The reverberation environment is 
also easily described mathematically, 
in this case the feedback of reflec¬ 
tions back into the system must be 
taken into account. The equation for 
the circuit in Figure 3 is 

Equation 2. 

y(t) = gl*x(t) + g2*x(t-T) + g3*y(t-T') 

The output y(t) at any time is the mix 
(sum) of the attenuated current input, 
an attenuated reflection of the input, 
and an attenuated reflection of the 
output. It is important to attenuate 


the original sound somewhat so that the range of a 16-bit 
integer is not exceeded when the reflections are added in. 

Finally, a C formulation can be constructed for each 
math equation. Equation 1 can be expressed as 

output = gainl * input + gain2 * reflection; 

where simple variables have replaced the components of 
the equation. For equation 2, the C expression is 

output = gainl * input + gain2 * input_reflection + gain3 
* output_reflection 
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Figure 2 Simple signal flow diagram 



output y 


tween object and listener. A computer must 'remember 
the reflection another way. One efficient means of doing 
this is the circular buffer. 

A circular buffer, also known as a FIFO (First-In-First- 
Out), is an array of contiguous memory with two associ¬ 
ated indexes. One index points to the 'head' of the buff¬ 
er, the next available location for writing. The second 
index points to the 'tail' of the buffer, the next location 
for reading. Samples of the sound are stored in the buff¬ 
er for the entire delay time of the reflection. The size of 
the buffer is computed from the delay time and the 
sampling rate (a field in the WAV header) as follows: 

/* compute buffer size, in bytes */ 

FIFOSIZE = Samples_Per_Second / 

1000 * Del ayInMilliseconds * 2 


Of course, the transition from theory to implementation is never 
that simple. The complexity falls mainly on the computation of 
the terms 

gain * reflection 


dwFIFOSize is the size of the buffer required to hold n_De- 
1 ay InMi Hi seconds worth of samples. For example, for an 
echo delay of 100 milliseconds and a sampling rate of 
22050 samples per second. 


The next section explains how these terms are computed. 

Implementing Echo 

A reflection may be thought of as the memory of a 
sound that occurred moments ago. In the real world, the 
memory of a reflection is contained in the air space be- 


FIFOSIZE = 22050/1000*100*2 = 4410 bytes, or 2205 samples 

Each sample is assumed to be two bytes, 16 bits, which 
is true of most modern high-quality audio. This is why I 
multiply by two in the buffer size computation. The buffer 
size would be half this number for 8-bit samples. 
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The classic FIFO has a write index 
(the head), a read index (the tail), and 
rules for updating each. Figure 4 
shows a circular buffer in various 
states of full, empty, and in-between. 

Figure 5 shows the pseudocode im¬ 
plementation of equation 1 using an 
integer FIFO. 

The FIFO size in samples is com¬ 
puted as half the FIFO size in bytes, 
since each sample is two bytes. As 
data is read and written to and from 
the FIFO, the tail chases the head un¬ 
til the FIFO fills up (head one position 
behind tail) or the FIFO becomes 
empty (tail equals head). 

When reading and writing of the 
FIFO are performed symmetrically, 
one read for every write, then only 
one index, not two, is required. This 
is the case in both equation 1 and equation 2. The FIFO is 
initialized with 'silence' (I'll explain silence in a moment) 
and assumed to always be full. The write index can thus 
always be assumed to be one position ahead of the read 
index. The read is done first, and then the read location is 
written with the current input. The result is much leaner 
code: 

/* implement Equation 1 */ 


In Windows, 16-bit sound samples are stored as signed 
integers. This means the softest sound which can be re¬ 
corded, essentially silence, is represented by the value - 
32 7 68 (0x80001. The loudest sound that can be recorded is 
represented by +32767. The value zero actually repre¬ 
sents a sound in the middle of the volume range, not si¬ 
lence. The FIFO is thus initialized with the value 0x8000 for 
each sample, which represents silence. The fact that a 
sound cannot in fact be 'negative', i.e., contain negative 


/* allocate and zero fifo */ 

output = input + g * fifo[index]; 

fifo[index] = input; 

index = (index+1) X FIFOSIZE; 


Figure 4 A circular buffer in various states 


Tail (Read) 


Empty 


Head (Write) Tan (Read) 


Full 


Head (Write) 




In Between (Dark Cells 
Hold Data) 


Head (Write) 


/nste/// qence™ 

Make The Best First Impression! 

Spend your time finishing your product, not its installation, 
with the best Windows installation builder on the market. 

You'll create your install in minutes with its object oriented 
installation factory™. Define install operations and order 
with property inspectors, not some bad language 

Its the only install that automates file compression and disk 
layout with a drag and drop interface that leaves its com¬ 
petitors far behind. You get all the features you want and it 
only uses ~80KB of disk space! Its yours for a limited time 
at a special price, because you really shouldn't be using an 
install that isn't as good as your product. 


Buy before 10-1-94 fora FREE Chicago Upgrade!. 
Supports multiple file groups, partial and un-install. 
File compression, splitting, and version checking. 
System file, INI, CONFIG.SYS and registry support. 
Progman groups, readme viewer and billboards. 
Gradient, bitmap or custom background window. 
International support and many more features. 
Royalty-free distribution. 

Mastercard and Visa accepted. 


$99.00 In September 
Order Now 1 - 800- 494- 0550 




22845 NE 8th Street Suite 314 
Redmond, WA 98053-7299 
Phone 206-836-0111 
FAX: 206-868-0550 


Instance 

Corporation 


□ Request 105 on Reader Service Card o 


September 1994 


Windows/DOS Developer’s Journal — Page 35 

















































the range of the scroll bars, which was set using the func¬ 
tion SetScroll Ranged. These two complexities make the 
implementation (Figure 6) look more complicated than it 
is. In fact, it is no more involved than the three lines of 
pseudocode above. 

Why is it okay to initialize the FIFO with silence? Si¬ 
lence represents a reflection which has not yet propagated 
to the output, and therefore contributes nothing. 

Implementing Reverb 

The implementation of reverb (see Figure 7) is very 
similar to the implementation of echo. The only difference 
is that, in addition to adding in the echo of the sound, I 
add the echo of previous outputs to the current output. 
Since two echoes are involved, two FIFOs are required, 
and two delay and attenuation parameters also. Other¬ 
wise, the implementation is almost identical to the imple¬ 
mentation of echo. 


A Sample Implementation 

This discussion has assumed that the sound data is al¬ 
ready present in memory, and that the data is played us¬ 
ing low-level MMSYSTEM calls. The techniques for loading 
WAV files and playing them using MMSYSTEM have been 
described in many other articles and so were not repeated 
here. The sample code shows how to do it (full source 
code for the sample implementation is on the code disk - 
see Contents page for availability information). Also, the 
discussion assumes that the sound data is 16 bits per 
sample, and so computes the FIFO sizes and arithmetic in 
integers. The code can easily be modified to deal with 
bytes for 8-bit sampled sound. 

The user interface for the sample code is very simple. 
When either ECFIO or REVERB is selected from the menu, 
a common file dialog box appears and you enter the 
name of the WAV file to load. A second dialog then ap¬ 
pears with scroll bars. For echo, there are three scroll bars, 
one to select the echo delay, another for original sound 
gain, and a third for echo attenuation. The reverb dialog 
contains the same scroll controls as the echo dialog, and 
also includes two extra scrolls for the reverb delay and 
reverb attenuation. 

The quality of the echo and reverb can be modified by 
altering the delay and attenuation parameters. For the 
echo circuit, decreasing the delay will gradually reduce the 
echo until, at very low delay times, it becomes undetect¬ 
able. Increasing the delay time increases the perception of 
distance in the echo. Increasing the delay too much will 
eventually result in an unpleasant, distorted sound, with 
the echo having no relation to the current output. Increas¬ 
ing the attenuation will weaken the echo, and decreasing 
this parameter will make it louder. For all the scroll bars, 
moving the thumb tab vertically upward increases the pa¬ 
rameter. Bear in mind that increasing attenuation actually 
decreases the energy of the reflection. 

In the reverb circuit, decreasing the delay in the output 
reflection will 'flatten' the sound, just as it does in the echo 
circuit. The sound can also be made closer to pure echo by 
increasing the attenuation in the output reflection. Doing 
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Figure 5 Pseudocode implementation of equation 
1 using an integer FIFO 


;add the attenuated sample from 100 milliseconds ago (the reflec¬ 
tion) to 

the current sample 
if (head NOT EQUAL tail) 

output = input + g * fifoftail] ;add attenuated 

ireflection to the input 

tail = (tail+1) * (FIFOSIZE/2) ;bump read index 

else 

Output ("Buffer is empty.") 

;pi ace current sample in fifo for later use as reflection 
if (((head+1) » (FIFOSIZE/2)) != tail) 

fifo[head] = input; ;place input into fifo 

head = (head+1) * (FIFOSIZE/2) ;update write index 

else 

Output ("Buffer is full.") 


energy, creates some problems in the implementation of 
the echo algorithm in Windows 3.1. Each sound sample 
must be converted to a strictly positive value before arith¬ 
metic can be done on it. Thus you may notice that in the 
sample code (see Figure 6) I add the value 0x7fff to every 
sample before doing the math on it to introduce echo. 
Also, I use scroll bars to set the values of the delay and 
gain parameters. Scroll bars return integers to represent 
the position of the thumb tab. In order to derive the true 
gain values from these thumb tab positions, I divide by 
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Figure 6 Sample code for adding echo 


/* add echo */ 

for (1=0. nlndex=0; 1<1p_wavehdr->dwBufferLength/2: 1++) { 

/* initialize the first FIFO full of sound data with 
silence */ 

if (i < dwFIFOSize/2) 

lpFIFO[nIndex] = 0x8000; 

/* compute attenuated reflection */ 

1 Reflection = ( (LONG) lpFIFO[nIndex] +0x7fffl) 
‘(LONG)nAttenuation; 

1 Reflection /= ATTENUATIONRANGE; 

/* compute output */ 

lOutput = ((LONG)hp_wavedata[i]+0x7fffL)*nGain; 
lOutput /= GAINRANGE; 
lOutput += 1 Reflection; 

/* save sample for later use as reflection */ 
lpFIFO[nIndex] = hp_wavedata[i]; 

/* echo is done in place, i.e. current sample is 
replaced with echo sample */ 

hp_wavedata[i] = (1nt)(lOutput-0x7fffL); 

/* update FIFO index */ 

nlndex = (nlndex + 1) l (dwFIFOSize/2); 

} 


this causes the reflection to dampen more quickly, essen¬ 
tially removing energy from the system more quickly and 
converging on a pure echo. Increasing the delay while de¬ 
creasing the attenuation keeps reflections in the system 
longer, which increases the reverberation effect. 


Figure 7 Sample code for implementing echo and 
reverb 


/* add echo and reverb */ 

for (1=0. nlndex=0, nlndex2=0; 1<lp_wavehdr->dwBufferLength/2; 1++) { 

/* initialize the FIFOs with silence */ 
ff (1 < dwFIFOSize/2) { 

lpFIFOtnlndex] = 0x8000; 
lpFIF02[nIndex2] = 8x8000; 

) 

/* compute attenuated reflections */ 

1 Reflection = ((LONG)lpFIFO[nIndex]+0x7fffL)*(LONG)nAttenuat1on; 

1Reflection /= ATTENUATIONRANGE; 

1 Reflection = ((L0NG)1 pFIFO2[nIndex2]+0x7fffL)*(LONG)nAttenuation2: 
lReflection2 /= ATTENUATIONRANGE; 

/* compute output */ 

lOutput = ((LONG)hp_wavedata[1 ]-*0x7 fffL)*nGa1n; 
lOutput /= GAINRANGE; 
lOutput += IReflection; 
lOutput ■*= 1 Reflection; 

/* save sample and output for later use as reflections*/ 
lpFIFOtnlndex] = hp_wavedata[1]; 
lpFIF02[nIndex2] = (1nt)(lOutput-0x7fffL); 

/* echo and reverb Is done In place, I.e. current sample Is replaced 
with echo sample */ 

hp_wavedata[1] = (int)(lOutput-0x7fffL); 

/* update FIFO Indices */ 

nlndex = (nlndex + 1) * (dwFIFOSize/2): 

nlndex2 = (nlndex2 + 1) I (dwFIF0S1ze2/2); 

) 


Additional reflection paths can be added to both cir¬ 
cuits to model more realistic environments, such as rooms 
and concert halls. The circuits themselves can be cascaded 
or paralleled to produce more realistic effects, and the de¬ 
lays in the reflection paths can be modulated dynamically 
for even more realism. □ 
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■ Windows Questions & Answers 



Paul Bonneau 


Send questions to Paul via Internet as 
paul@rdpub.com 
from CompuServe: 
>INTERNET:paul@rdpub.com 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

Paul answers all electronic 
communications but is unable to 
respond personally to hard copy/disk 
messages. 


In recent months the interaction between DOS INT 21 h and Windows has 
been the subject of a couple of Q&A columns and an article. The discussion 
has followed an evolutionary path, from hooking the real-mode 1ST 21h han¬ 
dler in the system VM (using a hack that must have made most of you shud¬ 
der), to a better solution using DPMI, to an even better solution for trapping 1ST 
21h's in non-system VMs using a real-mode handler in a VxD. A lot of this has 
been due to the sleuth work of one of our readers, Ton Plooy. 

I imagine some of you think the subject has been beaten to death, but a 
recent letter I received from Ton on the subject is important to pass on. The 
reason this stuff is important is that it is so poorly explained in the current 
documentation and literature, and because an understanding of how DOS and 
Windows fit together can help you make intelligent programming decisions. 
Another source of information will be provided by Andrew Schulman, who will 
be covering this topic in detail in a forthcoming book, Unauthorized Windows. 

Ton's letter is in the context of a VxD and application he wrote to trap 1ST 
21Hs from DOS VMs. 

Hi Paul, 

I took a look at using INT 21h trapping when 32-bit file access is enabled and 
found out that my trap app works only for file I/O in DOS boxes. The reason for 
this seems simple, trap.ism uses Hook_V86_Int_Cha1n to trap INT 21h. This works for 
Win 3.10 because all file I/O goes to real mode eventually to let DOS handle it. 
However, when ifsmgr (3.11 32-bit PM file I/O) is installed, Windows file I/O no 
longer goes through the V86 chain. The solution is to use Set/Get_PH_Int_Vector 
instead of Hook_V86_Int_Cha1n. 

Recently I came across your article about displaying active DOS app names in a 
window, which I hadn't noticed before. You made some important points in that 
article. First, the PSP + 2C - environment - application name method doesn't work 
for coimand.com. Very good, I gave up on this and never figured out why it didn't 
work for me (I tested with 'copy con tmp.dat'). Also, you said that the Push_C11- 
ent_State macro doesn't adjust the SP, which means you can't do any pushes. 
However, taking a look at this macro reveals it does do sub sp, SIZE Client_Reg 
(this is the 3.1 DDK, don't have the 3.0 at hand, maybe you used 3.0). 

Ton Plooy 

The first part of Ton's letter has implications for my VxD article in the June 
1994 issue. Just like Ton's trap.asm, it uses Hook_V86Jnt_Chain to intercept real- 
mode 1ST 21h's. if you wanted to modify the VxD to also see file I/O 1ST 21h's 
emanating from the system VM in Windows for Workgroups 3.11, you would 
additionally have to trap protected-mode interrupts using Set_PMJnt_Vector. 
Windows does not rely on DOS for the new 32-bit file I/O seen in Windows for 
Workgroups. Eventually, Windows will not rely on DOS at all. But Windows 
cannot simply do away with DOS's INT 21h interface; to do so would raise 
serious backwards compatibility issues. The moral of the story is that INT 21h is 
not about to go away anytime soon, but Windows' reliance on DOS to provide 
the functionality is. 

The second part of Ton's letter refers to the article 'Identify the Running 
DOS Application from Windows,' which appeared in the Dec. '92 issue. I be¬ 
lieve the problem was indeed that I was using the 3.0 DDK, but I have long 
since recycled the diskettes, so I cannot prove this. It would be nice to hear 


Paul was a developer ofHyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation 
as a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft 
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from any reader possessing the 3.0 DDK to help clear this 
up. You can find the macros Push__Client_State and 
Pop_Client_State in the file vm.inc, located in the 386 sub¬ 
directory. 

Another reader, Jean-Louis Leroy, wrote to clarify a 
question I had raised in the April '94 column. 

I have read your April column in W/DDJ. As far as I 
remember, there was no WinExec API In Windows prior to 
version 3. The recommended procedure was to use normal 
DOS services after issuing a GlobalCompact(-l). 

Jean-Louis Leroy CIS: 74221,306 


Extensions. However, I cannot find the equivalent func¬ 
tions in the multimedia references. This seems like a sim¬ 
ple problem so I must be missing something obvious. 

I have a Sound Blaster card, and the tones need to be 
played through it. I find it hard to believe that I cannot get 
a simple tone out of the Multimedia API. Would Microsoft 
abandon such a feature? I figure everyone writing multi- 
media programs such as mine will eventually want to use 
simple tones in addition to wave clips or MIDI files. 

Clifton Christian 
cliffwc@aol.com 


Thank you very much! This clears up a lot. To refresh 
readers' memories, in the April Q&A I was postulating as 
to why there is a protected-mode-only version of INT 21h 
function 4bh (which does the real work of UinExecO), in¬ 
stead of Windows just embedding the code inside the Uin¬ 
ExecO function itself. This clears up the mystery; the INT 
21h interface is for compatibility. If I had thought of it I 
could have checked this out myself, even though I no 
longer possess a copy of Windows 2.11, since the online 
documentation has a symbol indicating which version of 
the API each function made its debut in. It shows 3.0 for 
UinExecO. 



Visual C++ vl .5 
Borland C++ v4.0 
Symantec C++ v6.1 


Q l'm having a bit of trouble with generating a simple 
tone in Windows 3.1. Under Windows 3.0,1 used the 
following function to play a tone, given the duration and 
frequency: 

void MakeTone( int dur, long freq ) 

{ 

// freq - HIWORD is frequency in 
// hertz, LOWORD is a 

// fractional frequency 

// dur - clock ticks, 1-clock 
// tick is 2 milliseconds 

OpenSoundO; 

SetVoiceQueueSize( 1, 200 ); 

SetVoiceSound( 1, freq, dur ); 

StartSoundO; 

WaitSoundStateC S_QUEUEEMPTY ); 

CloseSoundO; 

} 

This function does not generate any sound under Win¬ 
dows 3.1, but still waits the given duration. The Windows 
3.1 SDK documentation states that these audio functions 
are now obsolete and that I should use the Multimedia 


A As you have discovered, most of the old sound func¬ 
tions have been stubbed out in Windows 3.1. Pro¬ 
grams using the functions continue to work, but they just 
don't produce any sound. The architecture of the sound 
manager in Windows 3.1 is completely different than in 
previous versions. The primitive functions in the old 
sound, drv have been superseded by the much more pow¬ 
erful and extensible multimedia architecture. Unfortu¬ 
nately, as you have discovered, there is a price for using 
this new functionality. My guess as to why the old func¬ 
tions were abandoned is probably that not many Win¬ 
dows applications were using them, and that they did not 
coexist well with the new multimedia architecture. 

Luckily, it is not difficult to use the new sound functions 
to provide the functionality you are accustomed to. The 
simplest method is to use MIDI output, but this only works 
on sound cards possessing a MIDI synthesizer, and not all 
of them do (especially the lower end 8-bit cards). With a 
little more work, it's possible to synthesize sampled wave¬ 
form audio data (a series of integers representing the am¬ 
plitude of the sound wave) and have the Windows multi- 
media API play the sound from it. 

Waveform Data 

Waveform audio data encodes sound as a sequence of 
sampled intensity values just like on an audio compact 
disc. Figure 1 shows how a sound wave might be sampled 
in order to be stored as a series of 16-bit binary values. 
The sampling rate is the number of samples per second 
the sound was recorded at. Playing a sound back at the 
same sampling rate it was recorded with reproduces (ap¬ 
proximately) the original sound. Two factors affect the fi¬ 
delity of waveform audio, the sampling rate and the sam¬ 
ple size. 

Most (perhaps all) Windows sound drivers accept only 
a few of the 65,535 possible sampling rates (Windows 
uses 16 bits to represent the sampling frequency in hertz). 
The most common sampling rates are 11,025Hz, 
22,050Hz, and 44,100Hz. More of the detail of the sam¬ 
pled sound is preserved at higher sampling rates, but the 
higher sampling rates mean you have to store more inte¬ 
gers to represent each second of sound. 
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Figure 1 Sampling a sound wave to be stored as a 
series of 16-bit binary values 



The sample size is the size of the integer used to repre¬ 
sent the amplitude of the original sound wave at each 
sample point. The precision of the recorded sound in¬ 
creases as the sample size increases. Once again, most 
Windows sound drivers only accept a subset of the possi¬ 
ble sample sizes, currently either 8 or 16 bits per sample. 
Samples can be interleaved for multiple channels of sound 
(the sequence of samples comprising a single multi-chan¬ 
nel sample is called a 'frame'). Monophonic and stereo¬ 
phonic are the only two formats I have encountered, al¬ 
though higher-end adapters may well support additional 
sound channels. 
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Windows provides three levels of 
sound API functions, from the high- 
level sndPlaySoundO function to the 
low-level wave functions. Most of the 
time, sndPlaySoundO provides all the 
functionality required by an applica¬ 
tion. sndPlaySoundO plays a sound 
from a given waveform audio file. 
This file conforms to the RIFF specifi¬ 
cation described in chapter 8 of the 
Multimedia Programmer's Reference. Es¬ 
sentially, a RIFF file is a series of 
'chunks'. 

A chunk is a nothing more than a 
block of data prefixed with a 4-byte 
tag (usually a 4-character ASCII string) 
and the length of the data block. 
Chunks can nest. The simplest audio 
waveform is the PCM (Pulse Code 
Modulation) format. All the sound in¬ 
formation is contained in a single 
chunk, the 'RIFF' chunk, which in 
turn contains two subchunks, the 
'fmt' chunk which contains a header 
describing the sound, and the 'data' 
chunk, which holds the actual sam¬ 
ples (see Figure 2 for the layout of a 
PCM file). Other formats exist, such as 
MSADPCM (Microsoft Adaptive Pulse 
Code Modulation), but PCM is the 
most common. 

sndPlaySoundO accepts two pa¬ 
rameters. The first is the pathname 
of the waveform audio file to play, 
and the second is a set of flags con¬ 
trolling sndPlaySoundO' s behavior. Fig¬ 
ure 3 summarizes these flags. 

wave.c (Listing 1) contains a rou¬ 
tine called FPlaySndO that generates 
a short waveform audio file in mem¬ 
ory by sampling a sine wave. The 
function calls sndPlaySoundO to play 
the sound, specifying the SND_LOOP 
flag to produce a continuous tone. 
The routine is synchronous, that is, it 
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does not return until the sound has finished playing. ! was 
careful to start the sampling at the start of a cycle and 
finish at the end, so that the sound is more or less con¬ 
tinuous at the point where the sound loops. Like the old 
SetVoiceSoundO function, FPlaySndO accepts a frequency 
and a duration, but in addition I also allow the caller to 


specify stereo or mono, the sampling rate, and the sample 
size. 

There are actually four functions in wave.c, two for in¬ 
itialization and cleanup, the one described above that 
plays the sound, and one to stop the current sound. The 
initialization function, FInitSndO, allocates space for the 


Listing 1 wave.c — Code to provide tone generation 


fie****************************************************/ 

PCMWAVEFORMAT wft: /* PCM stuff. */ 

/* wave.c */ 

CNK cnkData; /* PCM Data chunk. */ 

/* -- Simple tone generation. */ 

BYTE rgb[l] ; /* The sound data. */ 

/* -- To build: "cc -c -d -DSTR1CT wave.c” */ 

} SND; /* SouND. */ 

I*****************************************************/ 

#include <windows.h> 

/* Constants. */ 

♦include <windowsx.h> 

♦define rFreqMin 20. f /* Allowable frequency range. */ 

♦include <mmsystem.h> 

♦define rFreqMax 20000.f 

♦include <math.h> 

♦define cbBufMax (0x00010000 - sizeof(SND)) 

♦include <limits.h> 

#include "wave.h" 

/* Globals. */ 

/* Types. */ 

SND far *1 psnd ; 
float r2Pi; 

typedef struct 
{ 

BOOL FlnitSnd(void) 

DWORD lwTag: /* Tag. */ 

/■*■****★*★★*★★*****★★*★*★★★★**★★★*★★★★*★***★**★★*★★★•*■★★/ 

DWORD lcb; /* Size of data. */ 

/* -- Initialize this module. */ 

} CNK; /* ChuNK. */ 

! *★********★****★*★***★**★*★**★******■*•*★*★★*★★*★•*•*★*** j 
{ 

r2Pi = (floatKasin(l) * 4.0); 

typedef struct 
{ 

CNK cnkRiff; /* ’RIFF’ chunk. */ 

if (NULL == (Ipsnd = GlobalAllocPtr(GMEM MOVEABLE 1 

DWORD 1 wWaveld ; /* Must be ’WAVE’. */ 

GMEM SHARE. 0x00010000))) 

CNK cnkFormat; /* Wave specific format chunk. */ 

return FALSE; 
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sound buffer. I would have liked to use static storage for 
the buffer, but there is this very odd statement in the 
documentation to the effect that if a memory address is 
passed to sndPlaySoundO, the memory block must have 
been allocated with GHEM_SHARE. What makes this odd is 
that GMEM_SHARE is used to control ownership of a memory 
block. Without it, the task owns the memory, and the mem¬ 
ory will be automatically freed (if not explicitly freed by the 
task) when the task is terminated. With it, the module owns 


the memory. This is handy for DLLs, since it allows the 
DLL, and not the current task, to own global memory. 

But it's very odd for a task to allocate GMEM_SHARE mem¬ 
ory, since the memory will be owned by the task module. 
What this means is that if you have multiple instances of 
a task running, the GMEM_SHARE memory each allocates will 
not be automatically freed until the last instance termi¬ 
nates. Why this should have any bearing on 
sndPlaySoundO 's use of the memory is a mystery. Even if 


Listing 1 continued 

1 psnd->cnkRiff.lwTag = *( long *)"RIFF": 
lpsnd->cnkR1ff.lcb = sizeof(SND) - sizeof(CNK); 
lpsnd->lwWaveId = *(long *)"WAVE"; 
lpsnd->cnkFormat.lwTag » ‘(long *)"fmt 

Lpsnd->cnkFormat.lcb = sizeof ( PCMWAVEFORMAT); 
lpsnd->wft.wf.wFormatTag = WAVE_FORMAT_PCM: 
lpsnd->cnkData.lwTag = ‘(long *)”data"; 
return TRUE; 

} 

void CloseSnd(void) 

/★*★**★***★***★***★★***★★★★*★*•****★**★★*★*★★★★**★*★**★/ 

/* -- Close this module. */ 

/**★********★★**★**★★*★*★**★*******★★***★***★****★★★★*/ 
l 

if (NULL != lpsnd) 

GlobalFreePtr(lpsnd) ; 

} 

BOOL FPlaySndtfloat rFreq, long eras, UINT esps, 

UINT obit, UINT cchn) 

1 *****************************************************i 

/* -- Play the given sound. */ 

/* -- rFreq : Frequency of sound (Hz). */ 

/* -- ems : Duration (ms). */ 

/* -- esps : Sampling rate (Hz). */ 

/* -- cbit : Sample size (bits/sample/channel). */ 

/* -- cchn : Number of channels. */ 

1 ***************************************************** g 
( 

float r; /* General purpose. */ 

float csmpCycle; /* Samples per tone cycle. */ 

UINT cbSample; /* Bytes/sample (per channel). */ 

DWORD cbBufReq; /* Required buffer size. */ 

UINT csmpBuf; /* Sample count in buffer. */ 
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the driver uses a hidden task to play the sound, such a 
task will not be an instance of the calling task's module, 
and so will not be affected by the flag. Similarly, a DLL's 
view of task-allocated memory is unaffected by the flag. 

I have a couple of theories about why the documenta¬ 
tion states the flag should be used. The first is that it 
might be a simple documentation error. The other is that 
it may be some misguided attempt to solve a hard prob¬ 
lem: suppose a task has started playing an asynchronous 


Listing 1 continued 


UINT ismp, ismpT; /* Sample indices. */ 

UINT ichn; /* Channel index. */ 

DWORD mscStart; /* Tone onset time. */ 

if (rFreq < rFreqMin II rFreq > rFreqMax) 
return FALSE; /* Out of range. */ 

csmpCycle = csps / rFreq; 

csmpBuf = (UINTMcsmpCycle + 0.5); 

cbSample = cbit / 8; 

cbBufReq = csmpBuf * cbSample * cchn; 

if (cbBufMax < cbBufReq) 

return FALSE; /* Too big. */ 

lpsnd->wft.wf.nChannels = cchn; 
lpsnd->wft.wf.nSamplesPerSec = csps; 
lpsnd->wft.wf.nAvgBytesPerSec = 
csps * cchn * cbSample: 

1psnd->wft.wf.nBlockAlign = cchn * cbSample; 
lpsnd->wft.wBitsPerSample = cbit; 
lpsnd->cnkData.lcb = cbBufReq; 

1psnd->cnkRiff.lcb = cbBufReq + 
sizeof(SND) - sizeof(CNK); 
for (ismp = 0; ismp < csmpBuf; ismp++) 

{ 

r = (f1 oat)sin(r2Pi * ismp / csmpCycle); 
for (ichn * 0; ichn < cchn; ichn++) 

{ 

ismpT = ismp * cchn + ichn; 
if (cbSample == 1) 

lp$nd->rgb[ismpT] = 0x80 + 

(int)(128.0 * r); 

else 

((LPWORD)lpsnd->rgb)[ismpT] = 
(int)(SHRT_MAX * r); 

) 

} 

sndPlaySoundC(LPCSTR)lpsnd, 

SND_ASYNC | SND_MEMORY I SNDJ.00P); 
if (cms > 0) 

{ 

mscStart = timeGetTime(); 

while (timeGetTimeO - mscStart < (DWORD)cms) 

) 

return TRUE; 

} 

void StopSnd(void) 

^★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★* J 

/* -- Stop playing the current sound. */ 

/*****************************************************/ 
{ 

sndPlaySound(NULL. SND_ASYNC); 

) 

/* End of File */ 
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sound from memory, and then exits. 
Windows will free the memory con¬ 
taining the sound, and if the sound 
driver is not told to stop playing the 


sound, it will likely crash. But the 
GMEM_SHARE flag does not help this 
problem, regardless of its presence; 


Figure 2 Format for PCM RIFF file 
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main chunk contains all audio data (in two subchunks) 
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'fmt' 

subchunk contains header (PCMWAVEFORMAT structure) 
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wFormatTag 

1 for PCM, 2 for MSADPCM 
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average bytes/second (useful for compressed formats) 
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Figure 3 Flags for sndPlaySoundQ 

Name 

Value 

Purpose 

SND_ASYNC 

0x0001 

Allows sndPlaySoundO to return with sound playing. 

The default is synchronous; and PlaySoundO does not 
return until sound has finished playing. 

SND_NODEFAULT 

0x0002 

Prevents 'default' sound from being played if specified 
sound is not found. 

SNDJVI EMORY 

0x0004 

The first parameter is a pointer to a block of 
CMEM_SF1ARE memory containing an image of a 
waveform audio file. 

SND_LOOP 

0x0008 

Plays the given sound in a loop until a subsequent call 
to sndPlaySoundO- 

SND_NOSTOP 

0x0010 

Preventing any other action if a sound is currently playing. 
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once the task terminates, Windows will free the buffer. 

Just to be safe, FInitSndO allocates a block of the 
sound buffer using the GMEM_SHARE flag. The sound buffer is 
of type SND, which is defined at the top of wave.c (Listing 


1), based on the layout in Figure 2. FInitSndO also fills in 
the constant fields of the in-memory waveform audio buff¬ 
er. CloseSndO simply frees the buffer. 


Listing 2 wave.h — Interface to wave.c 


/*****************************************************/ 
/* wave.h */ 

/* -- Interface to simple tone generation function. */ 
/*****************************************************/ 
void CloseSnd(void); 
void StopSnd(void); 

BOOL FlnitSnd(void); 

BOOL FPlaySndtfloat rFreq, long cmsc, UINT csps, 

UINT cbit, UINT cchn); 

/* Available sample rates. */ 

#define cspsLo 11025 
#define cspsMid 22050 
#define cspsHi 44100 

/* Available sample sizes. */ 

#define cbitLo 8 
#define cbitHi 16 
/* End of File */ 


Listing 3 demowave.c — Demonstration program 


j*****************************************************j 


/* demowave.c */ 
/* -- Application demonstrates simple tone */ 
/* generation using MultiMedia wave functions. */ 
/* -- To build: "cc -d -DSTRICT demowave.c wave.obj */ 
/* mmsystem.lib demowave.rc" */ 


I *****************************************************j 

^include <windows.h> 

^include <windowsx.h> 

^include "demowave.h" 

#include "wave.h" 

/* Prototypes. */ 

BOOL CALLBACK _export FDlgProciHWND hwnd, UINT wm, 
WPARAM wParam, LPARAM IParam); 

LRESULT CALLBACK _export LwButtonWndProctHWND hwnd, 
UINT wm, WPARAM wParam, LPARAM IParam); 

/* Constants. */ 

f/define wmDown (WMJJSER+1000) /* Button went down. *1 

#define wmUp (WMJJSER+1001) /* Button went up. */ 

^define cmscPlay 1000 /* Duration of tone. */ 

/* Globals. */ 

WNDPROC lpfnButton; 
float rghz[] = 

{ 

440.00f, 466.16f, 493.88f, 523.25f, 554.37f, 

587.33f, 622.25f, 659.26f, 698.46f, 739.99f, 

783.99f, 830.61f 
}; 

#ifdef _BORLANDC_ 

^pragma argsused 
#endif 

int PASCAL WinMainCHINSTANCE hins, HINSTANCE hinsPrev, 
LPSTR lpsz, int wShow) 

j 

/* -- Entry point. */ 

/*****************************************************y 

{ 

WNDCLASS wcs; 


Listing 3 continued 


GetClassInfoiNULL, "Button”, Awes); 
lpfnButton = wcs.lpfnWndProc; 

if (NULL == hinsPrev) 

{ 

wcs.style &= ~CS_DBLCLK$; 
wcs.lpfnWndProc = LwButtonWndProc; 
wcs.hlnstance * hins; 
wcs.lpszMenuName = NULL; 
wcs.lpszClassName = szButtonClass; 
if (1RegisterClass(&wcs)) 
return 0; 

} 

if (FInitSndO) 

{ 

DialogBoxthins, MAKEINTRESOURCE(dlgWave), NULL. 

FDlgProc); 

CloseSndO; 

} 

return 0; 

} 
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Even though PlaySndO looks long, there is not much to 
the routine. The bulk is the housekeeping of updating the 
sound buffer header. The routine first checks to see if the 


requested frequency is reasonable. A sound frequency less 
than 20Hz not only is inaudible, but results in a large buff¬ 
er which takes a long time to fill. A frequency above 


Listing 3 continued 


LRESULT CALLBACK _export LwButtonWndProc(HWND hwnd, 
UINT wm, WPARAM wParam. LPARAM lParam) 

/*****★★★★★*★*★★*★★*★*★★★★★***★*★★★*★*★*★*★***★★★★★★*★f 

/* -- Push button subclass procedure. *1 

/*****************************************************/ 
t 

switch (wm) 

{ 

default: 

break; 

case WM_LBUTT0ND0WN: 

SendMessage(GetPa rent(hwnd), wmDown, 
GetWindowWord(hwnd, GWW_ID), lParam); 
break; 

case WM_LBUTTONUP: 

SendMes sage (GetPa rent (hwnd), wmUp, 
GetWindowWordOiwnd, GWW_ID), lParam); 
break; 

} 

return CallWindowProcdpfnButton, hwnd. wm, wParam. 
lParam); 

} 

BOOL CALLBACK _export FD1gProc(HWND hwnd, UINT wm, 
WPARAM wParam, LPARAM lParam) 
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/*****************************************************/ 
/* -- Dialog procedure. */ 

/ft****************************************************/ 

{ 

static UINT csps; /* Sampling rate (smp/sec). */ 

static UINT cbit: /* Bits per sample. */ 

switch (wm) 

{ 

default: 

break; 

case WMJNITDIALOG: 
csps = cspsMid; 

CheckRadioButton(hwnd, didLo, didHi, didMid); 
cbit = cbitHi; 

CheckRadioButton(hwnd. aid8, didl6, did8); 
CheckDlgButton(hwnd, didStereo, FALSE); 

CheckDlgButton(hwnd, didSync, FALSE); 
return TRUE; 

case wmDown; 

FP1aySnd(rghz[wParam - dldA], 
IsDlgButtonCheckedOiwnd, didSync) 7 
cmscPlay : -1. 
csps, cbit, 

IsDlgButtonCheckedOiwnd, didStereo) 7 2:1); 
return TRUE; 

case wmUp: 

StopSndO; 
return TRUE; 

case WM_COMMAND: 
switch (wParam) 

{ 

default: 

break; 

case IDCANCEL; 
case IDOK: 

EndDialog(hwnd, TRUE); 
return TRUE; 

case didLo: 

csps = cspsLo; 
break; 

case didMid: 

csps = cspsMid; 
break; 

case didHi: 

csps = cspsHi; 
break; 

case did8: 

cbit » cbitHi: 
break; 

case didl6: 

cbit * cbitLo; 
break; 

} /* End switch wParam. */ 

break; /* End case WM_COMMAND. */ 

} /* End switch wm. */ 

return FALSE; 

} 

/* End of File */ 
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20kHz is also inaudible, and will be very noisy, even at 
the maximum sample rate, since there will be very few 
(two or less) samples per cycle. PlaySndO will only play 
sounds within this range. 

The routine then calculates the number of bytes one 
cycle of the sound data will occupy, and returns early if 
this is greater than the size of the sound buffer. I allocated 
64Kb (including header) for the buffer in FInitSndO, which 
is really overkill, since today's sound cards, even at 20Hz, 
result in a maximum sound data size of: 

(44100Hz / 20Hz) samples 

* 2 bytes/sample/channel 

* 2 channels == 8820 bytes 

I picked 64Kb because this is the maximum addressable 
size (in 16-bit Windows) without using huge pointers. Only 
an unreasonable set of input parameters would necessi¬ 
tate a buffer larger than this. 

FPlaySndO next fills in the variable fields of the sound 
buffer. Aside from the byte counts in the RIFF file chunks, 
the variable fields are contained in the embedded struc¬ 
ture, PCMUAVEFORMAT, defined in the Windows include file 
msystem.h. After initializing the number-of-channels ( nChan - 
nels) and sample rate (nSamplesPerSedj members, FPlaySndO 
fills the nAvgBytesPerSecond member. For uncompressed 
sound formats, such as PCM, this is the exact value. But 
it is conceivable that a future, or third-party, installable 
compression/decompression DLL (called a "codec") could 


Listing 4 demowave.h — Constants for demo 
program 


/*****************************************************/ 
J* demowave.h */ 

7* -- Dialog constants for wave demo application. */ 
/*****************************************************/ 
♦define dlgWave 1000 
♦define didA 1001 
♦define didASharp 1002 
♦define didB 1003 
♦define didC 1004 
♦define didCSharp 1005 
♦define didD 1006 
♦define didDSharp 1007 
♦define didE 1008 
♦define didF 1009 
♦define didFSharp 1010 
♦define didG 1011 
♦define didGSharp 1012 

♦define didLo 1100 
♦define didMid 1101 
♦define didHi 1102 
♦define did8 1103 
♦define didl6 1104 
♦define didStereo 1105 
♦define didSync 1106 

♦define szButtonClass "MyButton" 

/* End of File */ 


compress different blocks of sound to different lengths. In 
this case the average bytes per second helps the sound 
driver manage its memory (e.g., allocating memory for in¬ 
ternal playback buffers). 


Lets Talk. 


Speech Systems, Inc. has answered the demand for powerful, 
accurate speech recognition with its Phonetic Engine ® 5 00 
(PE500™), a state-of-the-art speech recognition system for 
Microsoft ® Windows™ applications. 


Talking 
To Your 
Computer 
Is No 
Longer 
A Dream 
But A 
Reality 


The PE500 combines the features essential for de¬ 
veloping professional, speech-aware applications: 

• Continuous Speech, which allows you to speak with¬ 
out pauses between words. 

• Speaker Independence, which lets you speak imme¬ 
diately without training. 

• Large Active Vocabulary, which gives you more 
freedom when designing your application. 

• 40,000 Word Standard Dictionary, which you can 
expand with new words. 

PE500 System Development Kit (PE500 SDK) — 

$995. Includes the following: 

• Interactive Speech Card. 

• Software Development Tools for C, C++, and 
Visual Basic. 

• Noise-canceling microphone. 


To receive a copy of the white paper "How to 
Develop Speech-Aware Applications" or to 
order your copy of the PE500 SDK, please con¬ 
tact us at 303.938.UW, 303.938.1874 (fax), or 
at 2945 Center Green Court South, Boulder, 
Colorado 80301. 
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Listing 5 demowave.rc — Resource definitions for 

demo program 


/******★*****★***★★***★★*★★*★★★★★★*★★★*★**★**★★★★★★★*★/ 

/* demowave.rc 

*/ 

/* -- Dialog resource for wave demo application. 

*/ 

/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■A 1 ****/ 

♦include <w1ndows.h> 

♦include "demowave.h" 


dlgWave DIALOG DISCARDABLE 0, 0, 199, 98 

STYLE DS MODALFRAME I WS POPUP I WS VISIBLE I 

WS CAPTION 1 WS SYSMENU 

CAPTION "Wave" 

FONT 8. "MS Sans Serif" 




8 SEE what no 
other Windows 
debugger can 
show you. "WinScope 
lurks on your desktop and 
spies on messages, API calls, 
hooks, and more.” Watch a 
single window, module, func¬ 
tion, or message, the whole 
system, or anything in 
between. WinScope’s system- 
wide view lets it capture what 
other debuggers can't even 
see! 

8 THINK of WinScope 

as “a super API spy on 
steroids.” Trace virtually any 


support for your own and 
others' DLLs. 

NEWin 

Version 1.2. 

• Recover trace after crash 

• Capture interrupts and 
faults • Trace functions 
called via GetProcAddr 
•Scripts for TAPI, OLE 2, 
etc. • Multiple project 
directories • And more! 

WRITE better Windows 
code in 60 days, or get 
your money back. Sinfully 
Windows API, with parameters. WinScope’s■ easy to use,” WinScope paves the road to 


growing base of 2,000+ APIs (200+ un¬ 
documented) makes it the most compre¬ 
hensive API debugger available. And its 
powerful scripting feature lets you add 


better, cleaner Windows software, 

We guarantee it! Or return WinScope 
within 60 days and we’ll refund your 
money. 


“WinScope is the debugging marvel of the 90s. Every Windows developer 
absolutely must own this fantastic new tool. ” Tom Swan, PC Techniques 


Break down the barriers to Windows debugging! 

Order toll-free 800-722-7006. Only $149 with 60-day guarantee. 


1993 WINNER 


Indows 
" :h 
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COMPUTE 


CHOICE 

AWIRD 


imiMi 


THE PERISCOPE COMPANY, INC. - i •+/ j rcHumncc ji., juiic iuu - HiutniH, on juju 7 ■ 

404/888-5335 FAX 404/888-5520 FAX NOW 404/888-5344 COMPUSERVE GO PERISCOPE 


1475 PEACHTREE ST., SUITE 100 • ATLANTA, GA 30309 


The next member, nBlockAlign, depends on the sound 
data format. For the uncompressed PCM format, it speci¬ 
fies the total size of one frame's worth of data, so can be 
calculated with the formula: 

$ample_size * number_of_channels / 8 

where sample_size is given in bits per sample. FPlaySndO 
then sets the sample size member (uBitsPerSample) and two 
variable chunk lengths. 

The next task is to fill the sound buffer with samples. 
This is accomplished with an outer loop that iterates over 
the frames, and an inner loop that iterates over the chan¬ 
nels in each frame. The inner loop 
has to deal with two possible sample 
representations. 8-bit samples are un¬ 
signed quantities 'biased' by 0x80. 
This means that the neutral position 
(when the speaker cone is at rest) is 
at a sample value of 0x80, full posi¬ 
tive is a 0xff, and full negative is at 
0x00. But 16-bit samples are ex¬ 
pressed in signed, 2's-complement 
values (just like an int in C). 

The inner loop generates sine 
waves by determining the phase an¬ 
gle for each frame and calling the 
periodic math library function, sin(). 
You could just as easily replace this 
with your own periodic function to 
generate a tone in whatever wave¬ 
form you prefer. 

FPlaySndO then calls sndPlaySoundO 
to play the sound from memory, 
specifying the SND_ASYNC, SND_MEM0RY, 
and SND_L00P flags. But wasn't 
FPlaySndO also supposed to support 
synchronous sounds? Why is the 
SND_ASYNC flag always being passed to 
sndPlaySoundO ? It's quite simple. A 
continually looping synchronous 
sound will lock up your computer in 
an infinite loop. In fact, the 
sndPlaySoundO function insists that 
both SND_ASYNC and SND_L00P be used 
to produce looping sounds. I take 
care of FPlaySndO's synchronous be¬ 
havior by having it sit in a tight loop 
after calling sndPlaySoundO, waiting 
for the specified duration to expire. 
This is only done if the duration 
parameter to FPlaySndO, cms, is 
greater than 0. A value less than 
zero instructs FPlaySndO to play the 
sound asynchronously. The multime¬ 
dia time function timeGetTimeO is 
used to time the loop, since it is ac¬ 
curate to 1 ms. 
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Listing 5 

continued 



BEGIN 


CONTROL 

"B". didB, szButtonClass, 

GROUPBOX 

"AFrequency", -1, 4, 4, 44, 56 


WS_TABSTOP, 36, 68. 16. 28 

CONTROL 

"ALow”, didLo, "Button”, 

CONTROL 

"C", didC, szButtonClass, 


NS GROUP 1 BS AUTORADIOBUTTON, 


WS TABSTOP, 52, 68. 16. 28 


8, 20, 34, 10 

CONTROL 

”C#”, didCSharp, szButtonClass, 

CONTROL 

"AMid”, didMid, "Button", 


WS TABSTOP, 68, 68. 16, 28 


BS AUTORADIOBUTTON, 8. 32. 34. 10 

CONTROL 

"D", didD, szButtonClass, 

CONTROL 

"AHigh", didHi, "Button", 


WS TABSTOP, 84, 68. 16, 28 


BS AUTORAOIOBUTTON, 8, 44. 34. 10 

CONTROL 

"D#", didDSharp, szButtonClass, 

GROUPBOX 

"ASample”, -1, 52. 4. 43, 44 


WS TABSTOP, 100, 68, 16, 28 

CONTROL 

"A8 bit", did8, "Button", 

CONTROL 

"E", didE, szButtonClass, 


WS GROUP 1 BS AUTORADIOBUTTON, 


WS TABSTOP. 116, 68. 16, 28 


56, 20, 34, 10 

CONTROL 

"F". didF, szButtonClass, 

CONTROL 

"1A6 bit”, didl6, "Button". 


WS TABSTOP. 132, 68, 16, 28 


BS AUTO RADIOBUTTON, 56, 32, 34, 10 

CONTROL 

"F#". didFSharp, szButtonClass, 

CONTROL 

"SAtereo", didStereo, "Button”, 


WS TABSTOP, 148, 68. 16, 28 


WS GROUP | BS AUTOCHECKBOX 1 

CONTROL 

"G". didG, szButtonClass, 


WS TABSTOP, 


WS TABSTOP. 164, 68. 16, 28 


100, 24, 36, 10 

CONTROL 

"G#", didGSharp, szButtonClass, 

CONTROL 

"SAynchronous”, didSync, "Button". 


WS TABSTOP, 180, 68, 16. 28 


BS AUTOCHECKBOX I WS TABSTOP. 

DEFPUSHBUTTON 

"ADone", IDOK. 156, 8, 40, 14, 


100, 36, 60, 10 


WS GROUP 

CONTROL 

"A". didA, szButtonClass, 

WS GROUP 1 WS TABSTOP. 4. 68. 16, 28 

END 


CONTROL 

"A#”, didASharp, szButtonClass, 

WS_TABSTOP, 20, 68, 16. 28 




Creating a non-yielding loop is a bit of an obnoxious 
thing to do, since under 3.1, you will be completely hog¬ 
ging the CPU until FPlaySndO returns. You can help allevi¬ 
ate this by getting and dispatching messages from within 


the loop, but you then need to be careful about reen- 
trancy. You could take the same approach as modal dia¬ 
logs and disable input to your application while a synchro¬ 
nous sound is playing. The best approach, in my opinion. 
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is to always call FPlaySndO to play sounds asynchronously, 
to install a timer that is set to go off when the desired 
duration has elapsed, and to call the last function in 
wave.c, StopSndO, when it does. This complicates the imple¬ 
mentation somewhat, since you now have to clean up the 
timer, but the end result is a much more responsive sys¬ 
tem. If you are writing for NT, of course, the whole point 


is moot, since NT is preemptively 
multitasked. Under NT, as long as 
you don't mind having your own ap¬ 
plication appear unresponsive, play¬ 
ing a synchronous sound will not af¬ 
fect other tasks. The last function, 
StopSndO is implemented by calling 
sndPlaySoundO with a NULL sound pointer. 

Putting It All Together 

wave.h (Listing 2), is the include file 
that defines the interface to wave.c. In 
addition to the function prototypes, it 
contains the currently supported 
playback rates and samples sizes, de- 
mowave.c (Listing 3), demowave.h (Listing 
4), and demowave.rc (Listing 5) imple¬ 
ment a demonstration program, de- 
mowave.exe, that displays a dialog box 
with a row of buttons along the bot¬ 
tom that play the minor octave 
above middle C (440Hz through 
830.61 Hz). Figure 4 shows the dialog box from the demon¬ 
stration program. The dialog also has fields to control the 
sampling rate, sample size, whether the sound should be 
monophonic or stereophonic, and whether playback should 
be synchronous or asynchronous. Synchronous playback re¬ 
sults in a one-second tone whenever the mouse is down- 
clicked on a 'keyboard' button. □ 
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messagefO = MessageBoxO + sprintfO; 


James K. Lawless 
74217.531 @compuserve.com 

I often use MessageBoxO when testing Windows code. Usually, I simply want 
to ensure that certain variables contain reasonable values. To properly format 
the output string before calling MessageBoxO, I typically called a function from 
the sprintfO family. When writing these little snippets became tedious, I de¬ 
cided to try to merge the best of sprintfO and MessageBoxO into one function. 

The result of my efforts is a function called messagefO (in mdemo.c, Listing 1, 
with .def and .mak files for Microsoft C v8.0 shown in Listings 2 and 3). Like 
MessageBoxO, this function takes a series of parameters but it does not use a 
constant message-string. Rather, it expects a sprintf( J-like format-string and 
variable argument list. 

I use the ANSI standard variable argument support macros to isolate the 
beginning of the variable argument list. I then call _vsnprintf(), a Microsoft C 
function which indirectly calls sprintfO. 

After the string is formatted, a simple call to MessageBoxO displays the mes¬ 
sage to the user. The return value is retained in the variable 1 and is then 
returned to the caller of the function. 

You can create similar functions to augment other Windows functions that 
require constant strings as arguments (such as OutputDebugStringO). 

If this function is isolated within a DLL, the DLL should be compiled with the 
large memory-model or all pointer arguments should be explicitly cast to their 
far equivalents (the Windows usprintfO has this same restriction). Keep in 
mind that the function will lose its ability to format floating-point items when 
placed in a DLL. 



Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and "Tech Tips" 
editor for Windows/DOS Developer's Journal. His book, Illustrated C, was publish¬ 
ed in 1992. He may be contacted at 74 Marblehead St, North Reading, MA 01864. 
Internet address: leor@bdsoft.cora. 



















Large Fonts in STATIC Text Controls 


William Smith 
Montana Software 


I have worked on a couple of different Windows pro¬ 
grams where the customer wanted a very large font on 
a screen. One of these was a laboratory oriented appli¬ 
cation that monitored some instrumentation. The cus¬ 


tomer wanted some values displayed on the screen in 
very large letters so that they could be read from a dis¬ 
tance. 

Fortunately, Windows allows you to create fonts of just 
about any size. Once you get a device context, select the 
font object into the device, and determine where to dis¬ 
play the text, the DrawTextO and TextOutO functions will 
then work to display text in the large font. But this ap¬ 
proach ends up being a lot more work than just using a 
standard static text control. 

To use a large font in a static text control you must 
first use the UM_SETFONT message to change the font for the 



I ************************************************************************* 

MDEMO.C 

James K. Lawless 

A demo of messagefO: a printfO-like variant of MessageBoxO 

**************************************************************************y 


♦include <windows.h> 
♦include <stdio.h> 


long FAR PASCAL WndProc (HWND hWnd. WORD message. WORD wParam, LONG 
IParam) 

{ 

return DefWindowProcthWnd. message. wParam. IParam) ; 

} 


♦include <stdarg.h> 


int messagef(HWND hWnd. LPCSTR IpszTitle, UINT uFlags. LPCSTR IpszFmt. 

...) 

long FAR PASCAL WndProc (HWND, WORD, WORD, 

LONG) ; 

{ 

♦define BUF SZ (1024) 

int messagef(HWND, LPCSTR, DINT, LPCSTR, .. 

.): 

// Use ANSI variants of variable-argument 
// support macros. 

int PASCAL WinMain (HANDLE hlnstance, HANDLE hPrevInstance. 

vajist arg; 

LPSTR IpszCmdParam, int nCmdShow) 


{ 


int i; 

static char szAppName[] * "messagefO demo" : 


WNDCLASS wndclass; 


// Work buffer for output string 

HWND hWnd; 

MSG msg ; 


static char buff[BUF_SZ+1]: 



// Isolate the first variable argument 

if(1hPrevInstance) { 


// into "arg" 

wndclass.style = CS_HREDRAW 1 

wndclass.1pfnWndProc * WndProc : 

CSJREDRAW : 

va_start(arg.IpszFmt); 

wndclass.cbClsExtra * 0 ; 


// Use _vsnprintf() to indirectly call sprintfO 

wndclass.cbWndExtra * 0 ; 

wndclass.hlnstance * hlnstance ; 


_vsnprintf(buff.BUF_SZ.1pszFmt,arg); 

wndclass.hlcon = Loadlcon (NULL, IDLAPPLICATION) ; 

// Display the output string via MessageBoxO 

wndclass.hCursor * LoadCursor (NULL. IDC_ARR0W) ; 

wndclass.hbrBackground = GetStockObject (WH1TE_BRUSH) ; 

i=MessageBox(hWnd.buff.lpszTitle.uFlags): 

wndclass.IpszMenuName « NULL ; 


// Clean up.. 

wndclass.1pszClassName * szAppName ; 


va_end(arg); 

RegisterClass (iwndclass) : 


// Return value from MessageBoxO call 

) 


return(i); 

hWnd = CreateWindow (szAppName, 

// window class name 

♦undef BUF SZ 

"messagefO demo", 

// window caption 

} 

WS OVERLAPPEDWINDOW. 

// window style 

/* End of File */ 

CW USEDEFAULT. 

// initial x position 


CW USEDEFAULT. 

// initial y position 


CW USEDEFAULT. 

// initial x size 


CW USEDEFAULT. 

// initial y size 


NULL. 

// parent window handle 


NULL, 

// window menu handle 


hlnstance. 

// program instance handle 


NULL) ; 

// creation parameters 


ShowWindow(hWnd, nCmdShow) ; 
UpdateWindow(hWnd); 



messagef(NULL."messagefO demo”, MB_0K, 



"Main window handle is Jx ".hWnd); 



return msg.wParam : 

} 
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control. The following two Windows API calls will create a 
big font and set the font for a dialog control. 

/* Create the font for the big character display */ 
hFontBigChar = CreateFontf 64, 32, 0, 0, 700, 

0, 0, 0, ANSLCHARSET, OUT_STROKE_PRECIS, 
CLIP_STROKE_PRECIS, DEFAULT_QUALITY, 

FIXED_PITCH | FF_M0DERN, (LPSTR)"Courier New" ); 

/* Set the font for the big char control */ 
SendDlgltemMessaget hWndDlg, IDC_TEXT_BIGCHAR. 

WMJETFONT, hFontBi gChar, TRUE ); 

Once you have created the font and set the new font for 
the control, you set the text in the control using the 
SetDlgltemTextO function: 

SetDlgltemTextt hWndDlg, IDC_TEXT_BIGCHAR, "Big Char Text” ); 

Just be sure you make the control large enough to hold 
the large text. If the control is not large enough, Windows 
will clip the text. After Windows has destroyed the static 
text control and you no longer need the font, be sure to 
delete the font with the function DeleteObjectO. 

The static text control approach is much easier than 
getting a device context, selecting the font object into the 
device, figuring where to draw, and then finally displaying 
the text with TextOutO. 


Easy Printing from Windows 


William Smith 
Montana Software 


Adding printing capabilities to a Windows program is 
supposed to be easy: there is a universal interface to 
printer drivers regardless of the printer type. This sounds 
great, but the interface is a bit daunting to the uninitiated. 
It consists of a myriad of escape commands and GDI 
(Graphics Device Interface) functions. If all you need to do 
is dump some text to a printer, you begin to wonder if it's 
worth the effort. 

In fact, if all you need to do is output text, you can do 
it quite simply. Just open the printer device PRN as a file 
and then write to it in the standard way. 

For example, in C, all you need to do is call fopenO and 
fprintfO as follows. 

FILE fp = fopen( "PRN", "wt" ); 
fprintf( fp, "Output text\n" ); 
fclose( fp ); 



(Hands-On Windows Developer Training") 


Take Your Pick: MFC or OWL! 


C++ and Windows in a Week 
We teach experienced C program¬ 
mers the basics of C++ in two days, 
then add three days of Windows 
programming using a C++ class 
library. In C++, you learn the 
complete syntax (including tem¬ 
plates and exceptions), and how to 
begin "thinking in objects." The 
Windows course shows you how to 
design and build a modem Frame - 
Document - View Windows 
application. There are two versions: 
Visual C++ 1.5 with the Microsoft 
Foundation Classes and Borland's 
Object-Windows 2.0. Each course 
has plenty of hands-on experience 


Call Today To Register. 
Learn Object Technology 
and Windows NOW! 

V_ 


with the developer tools and visual 
assistants provided by the software 
publisher. 

C++ as a "Second Language" 

For programmers who have worked 
in languages other than C. The 
complete C++ language, with object- 
oriented analysis and design concepts. 
Four days. Graduates can enter our 
Windows course on Day 3. Generic 
C++, not specific to Windows or 
DOS. 

Also available: 

Intro to Visual Basic (Four days) 
Advanced Visual Basic (Three days) 


1 - 800 - 388-3535 

In MD call (301)230-1840 


Upcoming public courses 

C++AVin in a Week 
Borland 4.02, OWL 2: 

September 19-23 
Oct. 31 - Nov. 4 
Microsoft Visual C++ 1.5: 
September 12-16 
November 14-18 
Washington, DC Area 

Experience Counts! 

&msg has taught C++ and Windows since 
1989. We have been selected as a Borland 
Training Connection Member. All 
courses available for onsite presentation, 
including customization. 

&msg 

Messaging Systems Group, Inc. 

1559 Rockville Pike, Suite 250 
Rockville, MD 20852 . 
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Listing 2 

mdemo.def 

NAME 

MDEMO 

DESCRIPTION 

’messagef demo’ 

EXETYPE 

WINDOWS 

STUB 

’WINSTUB.EXE’ 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

8192 

EXPORTS 

WndProc 


Tech Tips Letters 


Josep Roman 
E-mail: jroman@mbt-ta.es 

Dear Leor, 

Regarding the problem stated in your article 'A Tale of 
Two Operating Systems' in the June 1994 Windows/DOS - 
I have had some similar experiences. 

Two months ago, after the purchase of a brand new 
state-of-the-art PC 486DX/66 with PCI bus and a 512 Mb 
Fujitsu hard disk attached to an 1540 SCSI Adaptec, I cre¬ 
ated a UNIX partition for my UnixWare Application Server 
and a primary DOS partition. Since installing UNIX is a 
more long-term process than DOS, I installed UNIX first, 
without problems. At the DOS side, I installed MS-DOS 5.0 


Emacs for Windows 


WinEmacs is a fully functional Windows 3.1 
version of the industry standard program editor 
Gnu Emacs, version 19.6. 


WinEmacs has these extended features 


• Separate buffers in different windows 

• Menu and drop-down menu bar 

• Multiple font size and type support 

• Cut and paste mouse support 

• Support for Text and Binary files 

• Clipboard support 

• Binds any arbitrary combination of key and 
key modifers to Emacs Lisp code 

Contact Pearl Software at pearlsoft.com (e-mail), 
510-652-4361 (voice) or 510-652-4362 (fax) for more 
information. Supported version costs $199. 

Call 1-800-WIN-EMACS 

We also provide EMACS consulting services. 

Pearl Software Corporation 

2000 Powell Street #1200, Emeryville, CA 94608 


without problems. Later, I installed Windows for Work¬ 
Groups and I got exactly your same message concerning 
the impossibility of creating a permanent swap file. 

Provided with my serial number, I called Microsoft 
Technical Support and after two or three weeks of work¬ 
ing on a typical trial-and-error basis with their suggestions, 
I was told that the problem was that my 'incompatible' 
hard disk controller did not support their Windows hard 
disk driver definition (called WDCTRL), and the problem 
had no solution. Upset with the news, I contacted Adap¬ 
tec's guys, with no success. 

In the meantime, I tried to install MS-DOS 6.2 and re¬ 
ceived the installation error 'Incompatible hard disk or de¬ 
vice driver. . . . follow the instructions in the SpeedStor 
section.' The set-up program was convinced that I had a 
hard disk with SpeedStor installed! 

Since I was pretty sure that my SCSI was totally com¬ 
patible (Norton Utilities and others confirmed my theory), I 
tried again using the '/U' parameter (no hardware check 
or compatibility test). The installation went fine and I've 
had no more problems to date. 

Finally, when I read your article regarding the WFWG's 
problem I tried your tip and it also solved the problem. 

So, the questions are: despite the 'public domain' 
knowledge about Microsoft's bugs, why doesn't Microsoft's 
Technical Staff try to solve the bugs instead of defending 
them as hardware/software compatibility problems? Is it a 
casual bug, or is giving strange errors when they detect a 
possible competitor (UnixWare in my case) on the same 
hard disk a way of enforcing their monopoly on the PC 
industry? 

I'm not convinced there has been any intention to mislead, 
at least not on the part of the Microsoft support engineers I've 
dealt directly with myself. Rather, I see the current state of affairs 
as a combination of three syndromes on the part of the engi¬ 
neers: 

1) a tendency to treat every caller as a non-technical user, 
generally underestimating the proficiency of callers who really 
do know what they are doing: 

2) a seeming need to reduce any problem to something they 
can find on In their database"; and, perhaps most insidious of 
all, 

3) apparently no incentive on the engineers' parts to ~get to 
the bottom ~ of a recurring problem. For example, I recently dis¬ 
covered a bug in Word for Windows 6.0a in which it refuses to 
turn off 'smart quotes'; i.e., when I type in C code in courier 
font, I have no choice but to display my double quotes as 'mir¬ 
ror image' pairs of stylized quotes rather than the plain ASCII 
vertically-oriented double quote character. The only solution the 
support engineer was able to suggest was that I do a global 
replace when my document is complete, which would be a pain 
even if I didn't have some quotes I wanted to leave intact in 
stylized form. I asked to be entered on the update list to receive 
a corrected version, was told there wasn't any such list, goodbye 
and thanks for calling Microsoft 

I've dealt with tech support engineers at several other large- 
ish PC vendors lately (Xircom, Quarterdeck, and Stac Electronics, 
to name a few) and found them all willing to spend the time 
necessary to track down incompatibility problems. Without my 
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Listing 3 mdemo.mak 


EXE=. 

OBJ=. 

SRC=. 

DEF=. 

INC=. 

RC=. 

ALL: $(EXE)\mdemo.exe 

#. 

# NMAKE file for mdemo 

$(EXE)\mdemo.exe : $(OBJ)\mdemo.obj $(DEF)\mdemo.def 

link /align:16 /nod $(OBJ)\mdemo,$(EXE)\mdemo.exe.NUL,11ibcew libw, $(DEF)\mdemo 
rc $(EXE)\mdemo.exe 

$(OBJ)\mdemo.obj : $(SRC)\mdemo.c 

cl /c /AL /Gsw /Ow /W2 /Zp /Fo$(OBJ)\mdemo.obj $(SRC)\mdemo.c 


ever identifying myself as a member of 
the press, each of these companies gave 
me the kind of support that said, “We're 
going to make this right, and here's the 
next thing to try . . until the Job got 
done. 

Microsoft, it would seem, just can't be 
bothered, whether or not I'm a W/DDJ 
columnist and whether I'm speaking to 
a support engineer or their PR firm. 

In my and Mr. Roman's case, my 
guess is there may be other operating 
systems that have, or still do, make 
changes to the partition table that end 
up causing Windows some kind of grief. 

However, rather than distinguishing be¬ 
tween the systems that may actually in¬ 
terfere with Windows and those that are 
relatively benign (such as SCO UNIX in 
my case, or UnixWare in Mr. Roman's), 
the Windows software seems to throw 
the baby out with the bath water. Then, for some reason, Mi¬ 
crosoft's support engineers feel compelled to defend this position. 

As a final note, my experience (and several UNIX-related op¬ 
erating systems' documentation) suggests that it is always safer 
to install MS-DOS first on a new hard disk, and then to install 
UNIX. Most operating systems contain some sort of multi-boot 
support, although often there's a limit of two operating systems 


per system. This multi-boot support behaves better when it sees 
an existing DOS installation around which to weave the UNIX 
partition. Then there are third-party products that provide ex¬ 
tended multi-boot capabilities supporting a large number of si¬ 
multaneous bootable operating systems - for example, check 
out a product named System Commander from V Communica¬ 
tions (San Jose, CA). -Iza 


Imagine a tool that finally gives polymorphism 
the attention it deserves... 

Imagine a tool that provides a direct, 
straight-forward mapping onto C++... 

Imagine a tool that stands by your side, 
not in your way... 


W Introducing ... 

W Object Foundry, 


i OO/C++ Design and Development Tool 



Engineered to help you tackle your toughest object- 
oriented development projects from people who know 
the importance of having the right tool for the job. 


•> Reverse engineering 

❖ Automatic diagram generation 

Automatic design document and code generation 
Fpatiirinp- * * On-demand consistency checking 
•> Complete user-extensibility 
<• Compatible with any C++ compiler 
■> Complete support for project teams 

❖ Supports distributed client/server designs 

For more information and a free demo disk call: 513-291-2924 


H 


Tools, Consulting & Training for OQ/C++ Development 

P.O. Box 59261, Centerville, OH 45459 • 513-291 -2924 • FAX: 513-885-5725 
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Peer to Peer LAN, to 250 nodes ^ 
$75 total software cost! A 

No matter how many nodes! 

Use Ethernet, Arcnet or 

serial/parallel/modem to connect. / 

Mixed mode routing 

Any combination of above connection is possible 
on any given node. 

Use with windows _____________ 

Seen as 100% compatible 

Microsoft Network GyBw \ 

by Windows 3.x. 111[ 


Information Modes 

P.O. Drawer F 
Denton TX 76202 
817-387-3339 Techline 
817-382-7407 Fax 

1-800-628-7992 Orders 


Lillie Big Lon 


Skeptical? We make believers! 


The $25 Network 


Try the 1st truly low cost LAN 

• Connect 2 or 3 PCs, XTs, ATs, PS/2s 
■ Uses serial ports and 5 wire caple 

• Runs at tISK baud, up to 90 feet 

• Transfer 8500 bytes per second (ATs) 

• Runs in background, totally transparent 

• Share any device, any file, any time 

• Needs only 15K of ram 

• Just S25 per network. NOT PER NODE1 

• Replace alt file transfer software 

• Version 2.3P now has TinyMAIL 

• OVER 20.000 SOLD WORLDWIDE 
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You can now get additional information about 
products and services you see advertised four ways! 



O Contact the vendor directly using the 
information in the advertisement. 


wdrs@rdpub.com Q Email your request to 

wdrs@rdpub.com. Make sure you 
include tnls magazine's issue 
number (5.09) and where you would 
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0 Circle the Reader Service number 
found under the ad or in this index 
on the bound-in Reader Service 
Response Card. Provide the 
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Windows Bug of the Month 

Paul Bonneau 


I ran into this month's bug while writing my article 
about handling huge memory. The code in that article 
needed to manipulate memory selectors, so I will start by 
briefly reviewing what selectors are. 

Under Windows B.1 enhanced mode, a 32-bit pointer is 
treated by the hardware as a 16-bit selector (the upper 
half) and a 16-bit offset (the lower half). To find the actual 
memory location that this address refers to, the hardware 
uses the 16-bit selector as an offset into something called 
the Local Descriptor Table (LDT), which the operating sys¬ 
tem creates and manages. The reason it is 'local' is that 
the hardware supports giving every task its own separate 
LDT, so that tasks cannot access each other's memory. 
However, Windows 3.1 uses a single LDT for all tasks, so 
tasks can read and write on each other's memory with 
abandon. 

Using your selector as a 16-bit offset into the LDT, the 
hardware locates a descriptor (each entry in the LDT is a 
descriptor). A descriptor is an eight-byte structure with 
fields that describe a chunk of memory. Important fields in 
the descriptor include the base, the limit, and the granular¬ 
ity. The base is just the 32-bit address of the first byte of 
the memory being referenced. The limit is a 20-bit field 
that contains the size of the memory being referenced, in 
bytes. 20 bits would only be enough to describe a chunk 
of memory up to 1Mb long. However, the granularity bit 
lets you reference even bigger pieces of memory. If the 
granularity bit in an LDT descriptor is on, then the limit 
field contains the number of 4096-byte blocks the mem¬ 
ory contains, rather than the number of bytes. 

The descriptor also indicates whether a chunk of mem¬ 
ory is code (read-only) or data (read/write), whether it con¬ 
tains 32-bit or 16-bit code, and so on. You could write 
many Windows programs and never think about selectors, 
but you are never very far from them. For example, when 


you call GlobalAllocO, it is really (among other things) cre¬ 
ating a selector in the LDT on your behalf with the correct 
size and attributes. 

Windows 3.1 gives you more direct access to the LDT 
than calling functions like GlobalAllocO. It also provides 
the lower-level functions AllocSelectorO, FreeSelectorO, 
GetSelectorBaseO, SetSelectorBaseO, and SetSelector- 
LimitO. However, you can find even lower-level software 
to manipulate the LDT. Windows must provide DPMI (DOS 
Protected-Mode Interface) services to both DOS shells and 
Windows applications, and the DPMI specification also 
contains entry points that let you manipulate the LDT. Pre¬ 
sumably, you would want to use the higher-level functions 
that Windows provides for selector manipulation rather 
than the primitive, interrupt-based DPMI, right? Wrong. 

When I wrote my code for using far pointers to handle 
more than 64Kb of memory, I originally used the Win¬ 
dows API functions AllocSelectorO, FreeSelectorO, GetSe¬ 
lectorBaseO, SetSelectorBaseO, and SetSelectorLimitO. 
However, the resulting code crashed under some condi¬ 
tions and I had to investigate how they really work. I dis¬ 
covered that their implementations are so buggy that I 
recommend avoiding them like an IBM mainframe. 

The problem stems from the fact that instead of relying 
on the underlying DPMI server, which provides correct im¬ 
plementations of the above API functions, KERNEL (the 
Windows DLL that implements most operating system 
functions) instead mucks directly with the LDT. According 
to Matt Pietrek's Windows Internals, this was done for the 
sake of speed. The KERNEL implementations work great 
when used by other KERNEL routines, but fail miserably in 
the general-purpose case. All of these functions save Al¬ 
locSelectorO and FreeSelectorO were undocumented in 
version 3.0, and in my opinion none of them should ever 
have been documented, especially since DPMI provides 
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correct implementations. However, Chapter 20 of the 
SDK's Programmer's Reference, Vol. 1, warned that an appli¬ 
cation need only use a very small subset of the available 
DPMI functionality. This may have had the unfortunate ef¬ 
fect of scaring many programmers into using the buggy 
KERNEL selector functions instead. 

One bug arises in SetSelectorLimitO. SetSelectorLimitO 
takes two arguments: the selector to modify, and a DWORD 
that contains the new limit for the selector's descriptor. As 
I already stated, the limit field in a selector's descriptor is 
either bytes (if the granularity bit is 0) or 4096-byte blocks 
(if the granularity bit is 1). But, as implemented, SetSelec¬ 
torLimitO implicitly assumes the granularity bit is 0. The 
function simply copies the passed-in limit field directly into 
the limit fields of the descriptor. This results in a big prob¬ 
lem. if the granularity bit is 1 , then the resulting limit ends 
up being 4096 times larger than the caller expects. The 
function needs to adjust both the granularity bit and the 
limit based on the granularity outcome. 

AllocSelectorO and FreeSelectorO also have problems. 
To create a new selector, you would normally need to 
specify all of the fields of its descriptor (base, limit, granu¬ 
larity bit, and several others). To make this process sim¬ 
pler, AllocSelectorO accepts as its single parameter a se¬ 
lector to use as a model for the new selector. The new 
selector's descriptor will be identical to the original selec¬ 
tor's descriptor. But this is not all that takes place. 

To support tiling of 64Kb blocks, AllocSelectorO looks 
at the limit field of the passed-in selector, and allocates an 
entire array of selectors sufficient to address the span of 
memory in 64Kb blocks. The first selector in the array is 
returned, which spans the entire range. The next selector 
starts at a linear memory address 64Kb after the first, with 
a limit field 64Kb less. This progression continues up to 
the last selector in the array. FreeSelectorO is designed to 
balance AllocSelectorO: it will free an array of selectors 
based on the limit field of the selector you pass it. The 
problems start if SetSelectorLimitO is used to change the 
limit field of the selector returned by 
AllocSelectorO. If the limit is made 
smaller by one or more 64Kb tiles, 
then a selector leak occurs when 
FreeSelectorO is called, since some 
selectors at the end of the array 
won't be freed. Conversely, if the 
limit field is increased, then FreeSe¬ 
lectorO will start freeing selectors 
past the end of the array, which may 
already be free, or, even worse, allo¬ 
cated by some other piece of code. 

The workaround to this problem 
is to use DPMI to manage selectors, 
rather than the Windows 3.1 func¬ 
tions. DPMI functions 0, 1, 6 , 7, 8 , 
and 9 provide the needed functional¬ 
ity. You call DPMI by loading a func¬ 
tion number in the AX register and 
executing an INT 31h. Function 0 allo¬ 
cates a selector from a pool of LDT 
selectors, but unlike GlobalAllocO, 


does not also allocate memory, and unlike AllocSelectorO, 
does not allocate a whole mess of them behind your 
back. Function 1 releases a selector (and only one selec¬ 
tor) back to the LDT selector pool. Function 6 returns the 
base field of the selector, and function 7 is used to set it. 

Function 9 is used to set the access rights and type for 
the selector. For a 16-bit Windows LDT selector these 
should be set as follows: 

• AvI bit (available) set to 0 (selector is in use). 

• D bit set to 0 (16-bit segment). 

• C bit set to 0 for byte granularity, 1 for page (4096- 
byte) granularity. 

• A bit set to 1, (selector has been accessed). 

• Type bits set to 1 (read/write data segment). 

• DPL set to 3 (descriptor privilege level of 3). 

• P set to 1 (selector is for a memory segment). 

You encode these values into the CX register and place the 
selector value in the BX register before issuing the INT 31h. 
The value in the CX register corresponding to the above 
setting is 00F3h. Function 9 will implicitly adjust the descrip¬ 
tor's granularity bit to accommodate the specified limit. If 
the limit specifies a block of memory greater than 1Mb, 
then the lower 12 bits must all be set. 

For an example of code that uses DPMI to manipulate 
selectors, see the article 'Far Pointers for Huge Memory' in 
this issue. 

Summary 

You could argue that these functions may work as de¬ 
signed and that their behavior is not a bug. However, the 
SDK documentation does not reveal that SetSelector¬ 
LimitO ignores the granularity bit, or that AllocSelectorO 
and FreeSelectorO operate on multiple selectors, not just 
one. Whether the actual behavior is a software bug or a 
documentation bug, the result can be the same for pro¬ 
grammers who follow the documentation: a crashed appli¬ 
cation and perhaps even a crashed system. □ 


a 

W/DDJ SDK Annotation #10 
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Driver Bug of the Month 

Paul Bonneau 


The target for this month's installment is the 'printer 
driver' installed by Delrina's WinFax 3.0. This application 
installs a printer driver so that any application's printer 
output can be redirected to the FAX modem, it's a neat 
idea; in essence you are printing to a remote device, over 
a phone line. 

The problem is that the driver fails to implement 
GetCharhlidthO. GetCharhlidthO is the Windows API function 
that returns the cell widths of the characters in the font 
currently selected into the specified device. This is a bit of 
a problem for any application that formats text for print¬ 
ing. For example, word processors typically maintain char¬ 
acter width arrays of the current font for both the screen 
and the printer. The printer is assumed to be the primary 
output device, so line breaks are calculated by summing 
the widths of the printer characters to see how many can 
fit across the output area on the printed page. That many 
characters are then displayed on the given line on the 
display. 

But the resolution of the printer is typically higher than 
that of the display, and, in fact, will not normally be an 
integer multiple of the display's resolution. As a result 
there is fractional error each time a character is positioned 
on the display. Word processors address this by spreading 
the error among the inter-character gaps. To do this, it is 
necessary to know the width of each character for the 
display. 


Both the line break calculation and the inter-character 
adjustment require a working GetCharhlidthO function (the 
visual effect is remarkable when the function does noth¬ 
ing). Fortunately, there is a workaround. The Windows 
functions fie tText Extent 0 and GetTextExtentPointO return 
the length of a string in the currently selected font for the 
given device ( GetTextExtentPointO is more portable to 
Win32). You can emulate GetCharUidthO by calling GetTex- 
tExtentO 256 times, each time with a string consisting of 
a single character (whose value is the same as the loop 
index). Probably the easiest thing to do is to provide a 
wrapper function for GetCharhlidthO, and have it first call 
GetCharhlidthO in the hopes it will work. If the return value 
comes back 0, have the wrapper function fall into the 
loop. 

It's a mystery why the WinFax 3.0 printer driver fails to 
implement the GetCharhlidthO function, when it clearly con¬ 
tains the supporting code to do so. □ 

If you have tracked down and conquered a nasty bug in 
someone's Windows driver, why not share it with other readers? 
Just email a detailed description of the bug along with any 
workaraounds you know of to paul@rdpub.com. We'll trade a 
bright purple W/DDJ T-shirt for any bug that we use. 
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Initialization Order 



Visual C++ vl .5 
Borland C++ v4.0 
Symantec C++ v6.1 


This is number twelve in a series of columns about the design and imple¬ 
mentation of WUIMAN (a Windows User Interface MANager). This installment 
looks at the problem of initialization order, as well as the problems that Visual 
C++ has supporting the large memory model. 

The Initialization Order Problem 

While working on the code for WUIMAN, I stopped to recompile with Visual 
C++ (most of the time, I use the Borland compiler). Suddenly, the code was 
severely broken. After some investigation, I figured out that one cause was a 
nasty problem with Visual C++ (discussed later in this article), but that the main 
culprit was a problem I had been glossing over from the beginning - initializa¬ 
tion order. 

WUIMAN contains a number of C++ classes that represent user interface 
objects (such as menus and windows) and attributes of those objects (such as 
color, font, and position). WUIMAN is designed to be extensible by deriving 
new C++ classes from the existing WUIMAN C++ classes. It is important that 
programmers not have to make any changes to the existing WUIMAN source 
when adding their own classes, otherwise those changes would have to be 
reincorporated each time WUIMAN itself gets updated. 


Ron Burk Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 

mer for 12 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronbSrdpub.com (“ . . . luunetlrdpubironb"). 
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One problem with this method of extensibility is the 
initialization order problem. Suppose you create a new 
kind of WUIMAN C++ class that is derived from a WUI- 
MAN C++ class that represents a window. You would 
probably put this class in a separate module, and that 


module might require some initialization at startup. For ex¬ 
ample, you might want to precompute some useful val¬ 
ues, or cache some objects your code makes extensive 
use of. Here's one way your module could get control at 
startup and shutdown time: 


Figure 1 Declarations for TWuiRegister 


class AWuiObject: 

typedef AWuiObject *(*WU1_INITFUNC)(const TWuiName Name): 
typedef void (*WUI_FINIFUNC)(const TWuiName Name): 

class TWuiMaster; 
class TWuiRegister 
{ 

public: 

TWuiRegister(const TWuiName Name, 

WUIJNITFUNC Constructor, WUI_FINIFUNC Destructor): 
-TWui Regi sterO; 
private: 

TWuiMaster *Master; 

): 


/* End of File */ 


class TStartStop 
{ 

public: 

TStartStopO { /* Inlt code here */ } 

-TStartStopO { /* shutdown stuff */ } 

}; 

static TStartStop Dumpy: 

By adding this code to your module, you cause code to be 
generated that will call the constructor for Durny at startup, 
and call the destructor for Dunrny at shutdown. 

This sounds pretty simple, but there is a subtle prob¬ 
lem: what if your startup code wants to make some use 
of the core WUIMAN code - has that code performed any 
startup initialization it needs? The answer is 'maybe.' C++ 
guarantees that static objects within a module will be in¬ 
itialized in the order they appear and deinitialized in the 


Listing 1 Definitions for Schwarz counter class 


// wuiregis.c - Definitions for WUIman object REGIStration code. 

♦include "wuiobjdb.h" 

/* 

The basic idea here is to implement a single class that provides an 
array of Schwartz counters. When the first static TWuiRegister object 
is constructed for a given WUIMAN class, it calls the corresponding 
ClassNewO function to create the master object for that class, and adds 
it to a list, along with a count of 1. Any further static TWuiRegister 
objects that register this class merely Increment the count. When these 
static objects get destroyed at shutdown, the corresponding count is 
decremented. When the count reaches zero, the master object’s 
ClassOeleteO function Is called. It is removed from the list, and then 
deleted. 

V 

class TWuiMaster 
I 

public: 

TWuiMastertconst TWuiName NewName. WUI_FINIFUNC D); 
const TWuiName Name; 
int Count: 

WULFINIFUNC Destructor: 

): 

TWuiMaster::TWuiMaster(const TWuiName NewName, WULFINIFUNC D) 

: Name(NewName), Count(l), Destructor(D) 

{) 

static TWuiGenerlcLIst ‘MasterObjects: 

static TWuiMaster *GetItem(const TWuiName Name) 

{ 

TWuiMaster ‘Item = 8; 

fordnt i=0: i < Master0bjects->NE1ements(): ++1) 

{ 

Item - (TWuiMaster *)Master0bjects->Get(1); 

1f(Item->Name ■■ Name) 
break: 

} 

return Item; 

) 


TWuiRegister::TWuiRegister(const TWuiName Name, 

WUIJNITFUNC ClassNew. WULFINIFUNC ClassDelete) 
{ MEMBERASSERTO: 

// Initialize list of master objects if necessary 
if(MasterObjects == NULL) 

{ 

MasterObjects = new TWuiGenericList(32); 
ASSERTfMasterObjects 1= NULL); 

) 

TWuiMaster ‘Item - Getltem(Name); 

// if this class is already registered 
ifdtem != NULL) 

// then just increment its usage count 
++Item->Count: 

else 

// else, add it to the list and call its ClassNewO 
{ 

AWuiObject ‘NewMaster = ClassNew(Name): 

ASSERT(NetvMaster I* NULL); 

Item = new TWuiMastertName, ClassDelete); 
ASSERTOtem != NULL); 

MasterObjects->Insert((void *)Item); 

) 

Master * Item; // store for later destruction 
) 

TWui Register::—TWui Regi sterO 
( MEMBERASSERTO; 

II first, locate this object on the list 
ASSERTtMaster 1= NULL): 

// if not last usage 
if(--Master->Count > 8) 

// then just decrement usage count 
return; 
else 

// else, give class chance to de-initialize 
( 

Master->Destructor(Master->Name); 

delete MasterObjects->Remove((void *)Master); 

) 

) 

I* End of File *1 
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reverse order. However, it makes no guarantee about the 
order in which the various modules in your program will 
be initialized. That was exactly the bug that bit me. While 
using Borland, I got lucky and the correct module got in¬ 
itialized first. When I switched to Visual C++, my luck ran 
out and one module tried to use an object that had not 
yet been initialized by another module. 

Initialization Order Solutions 

There are pretty much two solutions to this problem. 
First, every function that needs initialization performed can 
check a flag and, if the flag is FALSE, call a big initialization 
function and then set the flag to TRUE. That has the disad¬ 
vantage of requiring a lot of extra 
checks (one per function). The second 
solution is colloquially known as a 
Schwarz counter, after Jerry Schwarz, 
who used it in implementing C++ 
stream I/O. 

A Schwarz counter is a class decla¬ 
ration and a static instance of that 
class that you place in the header file 
for a given module. For example, 
your header file might look some¬ 
thing like this: 

class TMyCoolCl ass 
{ /*...*/ }; 
class TSchwarz 
{ 

static int Count; 
public: 

TSchwarzO { 

if(Count++ <= 0) 

StartFuncO; 

} 

-TSchwarzO { 

if(--Count <= 0) 

StopFuncO; 

} 

}; 

static TSchwarz Dummy; 

Note that this places a local object of 
type TSchwarz in every single module 
that includes your header file. The 
idea is, if another module derives a 
class from yours, it will first have to 
include your header file before deriv¬ 
ing its own class. That puts a copy of 
a TSchwarz in the module that is in 
front of any objects that the new 
module defines. Since initialization 
order within a single module is guar¬ 
anteed, you are guaranteed that your 
original class's module will have a 
chance to initialize before the mod¬ 
ule that depends on it. 

Neither of these solutions is free 
of problems, and reasonable pro¬ 


grammers may disagree on their relative utility. For exam¬ 
ple, Stroustrup's view (as expressed on page 98 of The De¬ 
sign and Evolution of C+f) is that Schwarz counters solve 
the ordering problem, mainly at the cost of some effi¬ 
ciency problems (if every module has a Schwarz counter, 
every module must be paged into memory at startup). 
Rob Murray, on the other hand, adjures 'Avoid initializa¬ 
tion object schemes that cause code to be executed in 
every compilation unit that includes a given header file' in 
his book C++ Strategies and Tactics. Murray's argument is 
that the use of templates can cause a proliferation of 
modules, making the overhead of Schwarz counters pro¬ 
hibitive. 


LANGUAGE 



-lint 


for C/C++ 

presents Bug # 704 


#include "iostream.h" 


int HighBits( long c ) 

{ 

if( c >> 16 == OxFFFF ) return 1; else return 0; 
} 

int main() 

{ 

cout << HighBits( OxFFFFOOOO ); 
return 0; 

} 


The programmer expected the value 1 to he printed since all the high hits of the 
argument to the function are 1. Instead 0 is printed. What went wrong? 

Call if you need a hint. Refer to Bug #704. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new s matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSi/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

Options Galore: A plethora of options for 
message suppression, message format, 
compiler dependencies, etc. All messages 
can be individually suppressed or enabled, 
both locally and globally. Numerous 
compilers/ libraries supported. Runs on 
MS-DOS (Optional built-in 386 DOS 
extender) and OS/2. 

PC-lint for C $139 
PC-lintfor C/C++ $239 

PC-lint users: call for update pricing 
Unix and Mainframe programmers: 
call for pricing for FlexeLint. 


PA add 6% sales tax. 


©imp®] S©fiwiir® 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610)584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 


D FAX #1082 □ 


September 1994 


Windows/DOS Developer’s Journal — Page 63 












Add a code disk subscription to your 
magazine subscription and get 12 disks 
(one each month) of Window/DOS 
Developer’s Journal listings. 

mm mmm • Hours of typing long code 
^A\/p • yourself from entering errors 

™ t 50% off the price of individual disks 


Windows/POS 

□ DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 

CODE DISK SUBSCRIPTION 

Only $ 30 (prepaid) a year 

$ 50 (Non North American) 


For more information or to order: 

CALL 913-841-1631 
FAX 913-841-2624 


WUIMAN's Solution 

WUIMAN has the advantage of being a fairly rigid set 
of classes. In extending WUIMAN, programmers have to 
derive from a fixed set of classes and provide certain func¬ 
tionality. My problem was to give them the opportunity to 
define startup and shutdown code for new classes, but to 
minimize the amount of effort required to do this, since 
many classes may not need startup or shutdown code. I 
tinkered with a variety of arrangements and eventually 
decided that Schwarz counters were the only reasonable 
way to go. However, it would not be acceptable to force 
programmers to create their own Schwarz counter class 
for each class they wanted to initialize. Therefore, I cre¬ 
ated a single, centralized class that maintains a list of 
Schwarz counters. 

One thing that every WUIMAN class needs to do at 
startup is create a master instance of itself and register it 
with the WUIMAN kernel. Previously, I provided a class 
called TUuiRegister for this purpose. For example, if you 
were defining a WUIMAN C++ class called TUuiMenu, the 
module containing that class would contain a definition 
like this: 

static TWuiRegister Dummy( 
new TWuiMenu("TWuiMenu")); 

At startup, this static object would get constructed, causing 
your class to be added to the list of classes available in 
the user interface. Unfortunately, with this scheme, the 
constructor for TUuiMenu could not count on other classes it 
might depend on being initialized. 

in my current design, every WUIMAN class has to de¬ 
fine a static startup function that performs initialization for 
that class. At a minimum, that initialization consists of cre¬ 
ating the first instance of itself and returning it. Every WUI¬ 
MAN class can also optionally define a shutdown function. 
The header file for a WUIMAN class should contain an 
object definition like this: 

class TMyClass : public TSomeWuiClass 

{/*...*/ 

static AWuiObject *Start(const TWuiName); 
static void Stop(const TWuiName); 

}; 

static TWuiRegister Dummy("TMyClass ,, > 

TMyClass::Start. TMyClass::Stop); 

i have redefined TUuiRegister so that it keeps a list of 
Schwarz counters, one for each class name that gets regis¬ 
tered. That way, even though many modules might con¬ 
tain a registration object for class TMyClass (because they 
included its header file), TMyClass::Start() and TMy¬ 
Class: :Stop() will only get called once. 

Figure 1 contains the declarations that support the new 
version of TUuiRegister. This code is a part of the central 
header file wuiobjdb.h on the code disk, wuiregis.h (Listing 
1) contains the new implementation of TUuiRegister. The 
main reason this code is broken into a separate module 
rather than grouped with the rest of the WUIMAN kernel, 
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is that it is only called at startup and shutdown, so if the 
linker places it in a separate code segment or page, it can 
remain swapped out most of the time. 

With this solution, one can still have initialization order 
problems. Most of the time, the natural order of header 
files will correspond to the correct order of module initiali¬ 
zation. However, a WUIMAN C++ class might depend on 
some WUIMAN C++ classes that implement attributes, and 
have no syntactical need to include their header file, be¬ 
fore declaring the new C++ class. About the best I can do 
for this problem is the document the fact that the inclu¬ 
sion of header files established initialization order, and to 
provide the ability to obtain a runtime trace that displays 
the actual order of initialization. 

Visual C++ versus Large Model 

Although recompiling with Visual C++ revealed my in¬ 
itialization order bug, it also revealed a severe problem 
with Visual C++ - I could no longer run multiple instances 
of my application. Before looking at what went wrong, a 
little history can be helpful. 

In the old days of Windows programming, Microsoft 
encouraged everyone to use the medium memory model 
(multiple far code segments, single near data segment). 
The reason is that Windows is lazy - it only handles re¬ 
loading and reinitializing a single data segment (the de¬ 
fault data segment, called DCROUP) when you start a sec¬ 
ond instance of your program. If Windows notices that 
your program contains more than one data segment, it 


simply refuses to load a second instance. Therefore, Mi¬ 
crosoft warned programmers to never use the large mem¬ 
ory model for Windows applications. 

Unfortunately, Microsoft really didn't have significant 
experience using C++ (at the time, they were still strug¬ 
gling to get their first C++ compiler onto the market) or 
they would have realized that the large memory model is 
essential for C++. Most any good-sized C++ program is 
likely to create more than 64Kb of objects, which means 
they won't all fit in the local data segment. If C++ objects 
are to be far rather than near, then all data must be im¬ 
plicitly far, otherwise a variety of implementation prob¬ 
lems emerge. Virtually all serious C++ projects use the 
large memory model. 

The real problem with the large memory model was 
having multiple data segments. Therefore, C++ vendors 
like Borland and Symantec (then Zortech) modified their 
compilers to place all data by default into DCROUP. Most 
C++ programs could arrange to fit essential static data 
(constants and the like) into 64Kb and, since the compiler 
did not generate multiple data segments, you could then 
use the large memory model and also run multiple in¬ 
stances of your program. Unfortunately, Microsoft's com¬ 
piler continued to generate multiple data segments for 
large memory model programs, and Microsoft support 
continued to warn programmers that you should avoid 
large memory model programs, without specifying that 
the real problem was only in Microsoft's C compiler. 
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This being the case, it was a great relief when Mi¬ 
crosoft finally released a compiler that offered proper sup¬ 
port for large memory model programming (and therefore 
for C++). Visual C++ offers the same scheme as Borland, 
so you can feel free to use the large memory model and 
still be able to run multiple instances of your program. At 
least, that is what I thought until recently. 

After some extensive changes, I recompiled and re¬ 
linked WUIMAN with Visual C++, only to discover that I 
could not run multiple instances. That meant that the ex¬ 
ecutable must contain multiple data segments and, sure 
enough, that was the case. After a lot of tedious tinkering, 
I discovered that any time you have a non-dynamic object 
(one that does not exist on the stack or the heap), Visual 
C++ generates a far data segment. For example, if you 
compile and link this module in with any large memory 
model Visual C++ Windows program, it will produce a far 
data segment and cause Windows to refuse to start a sec¬ 
ond instance of your application: 

class Dummy { int x; }; 
static Dummy Singlelnstance; 

The exact same module will not produce any such prob¬ 
lems with Borland or Symantec C++. 

I asked via Microsoft's CompuServe support forum if 
anyone knew of a command-line option to remedy this 
compiler behavior. Microsoft support did not reply, so I 
assume there is not. However, Steve Dirickson pointed out 


that you can label each offending object (and each refer¬ 
ence to it) with the _near keyword to avoid producing mul¬ 
tiple data segments. To say the least, that is not an attrac¬ 
tive option for non-trivial C++ projects that aspire to port¬ 
able code or that make use of portable third-party class 
libraries. Visual C++ has a number of strengths, but when 
it comes to supporting programmers who want to make 
extensive use of the language and write portable code, 
Visual C++ is dead last in the competition. 

Borland's Fix Arrives 

Just as I was finishing this column, the Borland service 
update, Borland C++ v4.02, arrived at my door. I believe 
this upgrade fixes the nasty problem that made Borland 
C++ DLLs unusable with non-Borland applications, but I 
haven't had a chance to try it out myself yet. I did have 
time to rebuild all my code with the new compiler without 
encountering any glitches. The upgrade also promises the 
ability to pop the debugger up automatically when your 
program encounters an error, but that ability is only avail¬ 
able for Chicago and Windows NT, not Windows 3.1. Up¬ 
grading from Borland C++ v4.0 costs $9.95 on CD, or $29.95 
on 3.5" diskettes. To order, call Borland at (800) 645-4559. 

Summary 

This month's code disk has the complete WUIMAN 
source for the project to date, including code from past 
issues. The code disk is widely available via sources listed 
in the table of contents. □ 


Windows/DOS Developer’s Journal 

is seeking articles on the topics listed 
below. In addition, we are interested in 
articles related to Windows NT, 
Win32s, and the Win32 API. If you 
have an idea for a related story and 
experience that would especially qualify 


Windows™/DOS Developer’s Journal 

Call For Papers 

you to write on one of these topics, 
contact our editorial staff for Author 
Guidelines at: 

Windows/DOS Developer’s Journal 

1601 West 23rd St„ Suite 200 
Lawrence, KS 66046-2743 
(913) 841-1631; FAX (913) 841-2624 


Proposals should include a short ab¬ 
stract, preferably followed by a one- 
page outline of the article. A brief re¬ 
sume of the author’s qualifications 
should accompany the proposal. 


C++ 

■ Proposals due 9/2/94 
manuscripts due 10/14/94 

Suggested topics: A C++ class to 
encapsulate WinG. Benchmarking the 
cost of putting C++ classes in DLLs. 
Tips on designing C++ DLLs for 
Chicago. A C++ class for caching 
bitmaps. 


Windows NT 

■ Proposals due 10/3/94 
manuscripts due 11/14/94 

Suggested topics: Tips on writing 
Chicago-compatible code. How to 
take advantage of Daytona’s new de¬ 
bugging API. C++ classes to ease 
Unicode support. A filter driver to dis¬ 
play all open files. 


Multimedia 

■ Proposals due 11/4/94 
manuscripts due 12/16/94 

Suggested topics: Using WinG for 
animation. Animation under Chicago. 
Using audio feedback in user inter¬ 
face design. Tips for faster graphics. 
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Advanced Windows NT: The Developer’s 
Guide to the Win 32 ™ Application 
Programming Interface 


Jeffrey Richter 
Microsoft Press, 1994. 

ISBN 1-55615-567-0 
700 pages (including index, etc.) 
$39.95 (includes a disk containing 
sample code) 


Reviewed by Paula Tomlinson 


When I see the word 'advanced' in the title of a win¬ 
dows programming book, my expectations are generally 
fairly high. Fortunately, I was not disappointed by Ad¬ 
vanced Windows NT. The book provides in-depth coverage 
of what the author believes are the most useful new pro¬ 
gramming features of Win32 on Windows NT. This is the 
kind of information that is missing, necessarily, in most 
entry-level programming books. But don't let that scare 
you away. This book is targeted towards experienced win¬ 
dows programmers, not necessarily advanced program¬ 
mers. A little programming experience in Windows 3.x is 
enough to get you started on it. 

I found the sample programs to be useful and relevant. 
Each major topic has at least one example program to 
demonstrate the concepts. Some of the samples are fairly 
simple demonstrations of the topic or functions being dis¬ 
cussed, while others, such as the supermarket simulation 
in the chapter on synchronization, are fairly sophisticated. 
All the samples are in C. Richter used the Microsoft SDK 
tools as his primary development environment but says 


that he has also compiled 'most' of them on Borland's 
32-bit C++ compiler for Win32 (Intel only). Although he 
doesn't go into much detail, apparently getting the sam¬ 
ples to compile with the Borland tools required some 
modifications in the following areas: named data sections, 
static thread-local storage, and structured exception han¬ 
dling. The samples are all reported to have been tested on 
a DEC Alpha and a MIPS machine in addition to an x86 
machine. Another nice touch is that the samples can be 
compiled natively for both ANSI and Unicode. However, 
because the book is focused on some of the more sophis¬ 
ticated features of Windows NT, many of the examples 
won't run on Win32s (Win32s is the subset of Win32 that 
allows 32-bit programs using a limited subset of the 
Win32 API to run on Windows 3.1). The $39.95 price in¬ 
cludes a disk containing all the sample programs. The disk 
includes both the x86 and MIPS versions of all .EXEs and 
DLLs, as well as a batch file that conveniently builds all 
the samples. 


Paula Tomlinson received an Electrical Engineering degree from Colorado State University. For the past six years she has developed 
various DOS, Windows, and Windows NT-based drivers and commercial applications for the HP ScanJet scanners, the HP LaserJet 
Fax, and the HP DeskJet printers. She is currently working on a book tentatively titled Writing Device Drivers for Windows NT. The 
opinions expressed in this article are hers alone and do not necessarily reflect the opinions of Hewlett-Packard. Send questions or 
correspondence to Paula via internet as pauiat@vcd.hp.com. 







To whet your appetite, I'll give a brief summary of the 
major topics in this book. 

Processes and Threads 

The first chapter provides a good description of the life¬ 
time of threads and processes, including what happens 
when processes and threads terminate and how the sys¬ 
tem schedules them for execution. Richter also spends a 
little time describing the object-based nature of Windows 
NT, including the difference between Win32 objects (ob¬ 
jects that don't apply to the POSIX or OS/2 subsystems) 
and Windows NT objects (objects that apply to all environ¬ 
ment subsystems). Understanding the visibility of objects is 
key to understanding Windows NT. Objects are process- 
relative: this means that you can't pass an object created 
in one thread to another thread in a different process. 
One exception to this is object inheritance; when the proc¬ 
ess is created, you can specify if you want the handles it 
creates to be inheritable by any processes that the parent 
process creates. 

A mistake common to programmers just beginning to 
program in a multithreaded, preemptive operations sys¬ 
tem, is over-using threads. Richter offers a welcome dis¬ 
cussion and some practical tips on when it might make 
sense to use a thread to accomplish a particular task (such 
as creating a lower priority thread to 
perform a background operation), 
then points out some of the common 
pitfalls, such as synchronization prob¬ 


lems. He also describes the priority class of processes and 
the relative priority levels of threads within the process. 

Memory Management - Heaps, Virtual 
Memory, and Memory-Mapped Files 

In Windows NT, a default heap is created for each 
process and is accessible only to that process. There is no 
distinction between the local and global heap. Although 
the Windows 3.x memory management functions are sup¬ 
ported for backwards compatibility, they map to the new 
heap functions, so they are generally faster. Any Windows 
3.x memory functions that are x86-specific have been re¬ 
moved altogether from Win32; this includes such routines 
as Global DOSAUocO, AllocDStoCSAliasO, and Global- 
PageLockO. Richter presents several scenarios where using 
multiple heaps makes sense and discusses the issues of 
serializing access to the heaps. He also provides a C++ 
example of overloading the new and delete operators to 
use the new heap routines. 

Windows NT uses virtual memory to provide each run¬ 
ning process with a 2-G address space. However, virtual 
memory can also be allocated and used by applications. 
Dealing with virtual memory is a two-stage process. The 
virtual memory is first reserved, then committed - the 
memory is not allocated or mapped until it is committed. 
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Windows/DOS Developer’s 
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list available to vendors of 
products we think our 
readers will find interesting. 
Current subscribers receive 
free information in the mail 


If you prefer that your name 
not be used in these 
mailings, please let us 
know. Just copy or clip this 
form and send it with your 
name and address to: 
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File Edit Bookmark Help 


EscapeCommFunction (2.x) 


t/'LONG EscapeCommFunction( ic/ComDev: nFunciion') 

int idComDev: P identifies communications device */ 
int nFunciion: P code of extended function */ 


Annotate 


Annotation: 


The documentation omits one potential value for 
the nFunction parameter, although it is defined 
in windows.h. The name is GETBASEIRQ and it 
returns the base address of the COM port in the 
lower word and the IRQ setting in the high word. 
If the high word is -1 the port doesn't exist; if it 
is 0, the comm driver does not support this 
escape (which is the case, for example with 
some kinds of enhanced serial boards). 

Submitted by Thomas Zeisluft. 

[Add this annotation to your own online API help 
file by pressing Alt-E-AJ 


Save 


Cancel 


Delete 
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Paste 
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There is a complete new set of 
Win32 functions for working with vir¬ 
tual memory. Richter describes some 
of the details of how the system allo¬ 
cates and maps virtual memory and 
what granularity and alignment is 
used. He also discusses several strate¬ 
gies for managing virtual memory ef¬ 
ficiently and concludes with a particu¬ 
larly interesting sample program that 
uses virtual memory to manage a 
large spreadsheet. 

Memory-mapped files are used in¬ 
ternally to load and execute pro¬ 
grams (EXEs and DLLs). With mem¬ 
ory-mapped files you can access a 
file as if it were in memory. Once a 
file is mapped, the system takes care 
of all the paging, buffering, and cach¬ 
ing work. Memory-mapped files are 
also the only supported way of shar¬ 
ing a block of memory between 
processes. To use memory-mapped 
files, you create a file-mapping object 
and then map a view of that file into 
memory. To share a file-mapping ob¬ 
ject between processes, you assign a 
name to it when the file-mapping 
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MessaqeBox (2.x) 


^int yAessaqeBox( /-Mnc/Pe/pr/! IpszTeM IpszT/tle, tuSt\.-ie) 


-- 


tate 






Annotation: 


Do not call MessageBox() from within the 
LibMainf) ol an implicitly-linked DLL. It will fail 
because the application will not yet have a 
message queue at that point, and MessageBox() 
[or anything else) cannot create its window when 
the message queue does not yet exist. Once the 
application executes its internal startup code and 
calls InitAppf). then it has a message queue and 
can safely call functions that create windows. 

[Add this annotation to your own online API help 
file by pressing Alt-E-AJ 


Save 


Cancel 
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LB ADDSTRING (2.x) 


IB_ADDSTRING 
vPaxant ■JL 


.<*. ng. t... used..... must ...be zero V.. 




Annotation: 


If you ate changing the content* of a listbox (fot example, by adding 01 deleting 
multiple sitings), you may want to minimize scteen redrawing and maximize 
speed by disabling window tedtawing duung yout operation Follow these steps: 

1) Send a WM_REDRAW with wParam equal to FALSE to the listbox. 

2) Perfotm your adds or deletes. 

3) Send a WM_REDRAW with wParam equal to TRUE to the listbox. 

4) Use InvalidateRectf) to force the listbox to redraw itself. 

[Add this annotation to your own online API help file by pressing All-E-A] 





object is created. Other processes can then open that file¬ 
mapping object by that name. If you pass NULL as the file 
handle when creating a file mapping object, the system 
knows that you are using a block of memory rather than 
a file on disk. The book discusses some of the issues of 
coherency when mapping multiple views and how the 
system uses the copy-on-write feature to allow one map¬ 
ping to be written to without affecting the other map¬ 
pings. 

Synchronization 

There are four main synchronization objects: critical 
sections, mutexes, semaphores, and events. Using syn¬ 
chronization objects is not only safer than looping in your 
code while you're waiting for a variable to change, it's 
also much more efficient. When a thread is waiting for an 
object or event, it is not scheduled for execution by the 
CPU and thus does not waste any CPU time. Richter de¬ 
scribes how each type of synchronization object is used 
and when it makes sense to use each type. He also ex¬ 
plains how to avoid such common synchronization pitfalls 
as deadlock conditions (a condition where two threads are 
indefinitely waiting on each other to signal an event). 
There are sample programs to demonstrate each type of 
synchronization object, including a fairly sophisticated su¬ 
permarket simulation that demonstrates the concepts of 
synchronization. 

Win32 Environment Subsystem 

This chapter contains a lot of background information 
that I found interesting but some less enthusiastic readers 
might choose to skip. Richter describes preemptive multi¬ 
tasking, thread scheduling, objects and object ownership, 
and message processing. He also discusses the Client/serv¬ 
er architecture of Windows NT. For any kind of input or 
output to the screen, the application is the client and the 
Win32 subsystem is the server, carrying out the requests 


of the client. Passing requests from 
applications from the system DLL 
stubs (such as user32.dll and 
gd132.dll) to the Win32 subsystem 
entails using a local procedure call 
(LPC) and global shared memory to 
transfer data between the process 
and the Win32 subsystem. 

DLLs 

In Windows 3.x, a DLL's code and 
data are loaded into memory only 
once. Since any applications loading 
this DLL are referencing the same 
data, DLLs can be used to share data 
between Windows 3.x applications. 
In Windows NT, a DLL is loaded into 
memory only once and then its code 
and data are mapped into the ad¬ 
dress space of any process that loads 
it. Each mapped view of the DLL re¬ 
ceives its own set of global and static 
variables, so they can't be shared be¬ 
tween processes. Also, Windows NT DLLs do not have 
their own local heap. When the DLL allocates memory, it 
comes from the process's address space and thus can't be 
accessed by another process. Richter explains how DLLs 
are loaded into memory and how the system determines 
what base address to load the DLL at. He also describes 
the concept of 'sections' in a DLL (or EXE). By placing vari¬ 
ables in their own sections, you can enable sharing them 
between multiple mappings of the DLL (or EXE). 

Thread-Local Storage 

Thread-local storage (TIs) allows you to associate data 
with a specific thread. This is especially useful in DLLs that 
are passed information that is later referenced again by 
the same calling thread. You will also find TIs convenient 
if you are porting 16-bit Windows code that relied heavily 
on global and static data. Since each thread gets its own 
stack, all local data is already thread-specific data. When a 
thread is created it gets an array (currently 64 elements in 
size) of 32-bit (LPVOID) values that can be used to store 
TIs data. Although each thread gets its own array, only 
one thread can allocate a particular index into the array 
at a time. 

You can also allocate thread-local global or static vari¬ 
ables. To declare a variable as TIs you simply use the 
_cdeclspec(thread) modifier as a prefix before the variable 
declaration. This tells the compiler (this may vary with 
compilers from vendors other than Microsoft) that the 
variable should be stored in its own section in the file. The 
compiler puts all the variables you've defined this way 
into a section called .tls and the linker combines all the 
.tls sections from all the object files into one .tls section 
for the whole executable or DLL. The system has to do 
more work to manage this special section, so using Tls 
static or global variables may slow your program down 
slightly. 
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C CODE FOR THE PC 

source code, of course 

NEW! Wintertree Build-in Sentry Spell-Checker Engine and ThesDB Thesaurus Engine (C/C++API, no royalties, powerful, full source) . . . each $450 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence).$370 

TE Editor Developer’s Kit for Windows V 4.0 (full screen editor, undo command, word processing; TER for application build-in; no royalties) $300 
C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner, specify Cor C++)$260 
Victor Image Processing Library V3.1 (brightness, contrast, merge images, TIFF/GIF/PCX; color reduction source $395; Windows $550) . . $250 

TUrboTJ^X (Release 3.1; HP, PS, dot drivers; CM fonts; LaTjjX; MetaFont).$250 

Crusher! V2.00 (platform-independent data compression for network transfer; beats PK & LH on binary; directory trees; portable C) ... . $215 

TE.Editor Developer’s Kit V3.0 (full screen editor, undo command, multiple windows; V3.5 with Word Processing $280).$190 

COMM-DRV Version 14 (complete interrupt-driven serial communication libraries & device drivers; full source) .$155 

Mi nix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

Delorie GCC for MS-DOS (Version 22.2; includes C+ +, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

NE W! JAKE 3.0 (embeddable natural language processing engine for queries in English to databases, games, help systems, etc.).$150 

Moby Crypto II (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . $150 
Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs, two big manuals) . . $140 

Ibrow (Version 4.1; programmer’s Windows-based editor, large files, help, undo/redo, drag-n-drop, function & type tags).$135 

Cheaper! XASM (cross assemblers & utility programs; 65xx, 68xx, 8Qxx; Intel or Motorola hex format; macro preprocessor).$125 

NEW! OSF/Motif 1.2.3 (port of Metrolink OSF/Motif to Linux; single CPU license).$105 

SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-1D5/JACAL-1 A3) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Ctynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, ND1S/ODI drivers, Beholder, more) . . . $100 

Updated! DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

CELP 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unix code).$80 

CPPCOMM V3.0m (C+ + serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem).$75 

ETNeuroKit V3.1 (back error propagation and Kohonen).$75 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS Version 1.10 (Purdue Compiler Construction Tool Set; like YACC and LEX together with lots of additional features).$60 

Container Lite V1.87 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator; Windows compatible; manuals on disk).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pack (20 public domain editors; micromacs 3.12 Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export).$40 

Database Pack (9 databases - simple to complex; DOS: isam, bplus, AVL, SDB, ID, gdbm; Unix: Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++in C) .$35 

OCT (Object CHanslator; essentially Brad Cox’s Objective-C Version 4) .$35 

RXC & EGREP Version 20 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes C and C++ grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

GNU Awk & Diff for PC (both programs in one package).$30 

NE W! Garbage Collecting Pointers (smart C+ + pointers; no need to delete; detect NULL and out-of-bounds pointers) .$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

NE W! OORT (C+ + ray tracing code from the book by Nicholas Wilt) .$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++, lots of .el files) .$25 

NEW! CTask Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

FLEX Version 2.4.3 (fast lexical analyzer generator; new, improved LEX).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, "common sense”, concept related searches) .$500 

Moby Pronundator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, corelist for spell checkers) . . . $100 

NEW! Linux Bible (Everythingyou ever wanted to know about Linux, 700+ page book).$40 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; 5.25” HD only).$35 

U. S. Cities (names & longitude/latitude of 32000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries) .$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, linguistics/natural language).$105 

OmniMap (street-level US mapping; lots of topographical features, Windows viewer, output to many file formats).$75 

Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code).$60 

Whlnut Creek Libris Britannia (over 60OMB of the best of British boards; not all source included).$50 

W&lnut Creek C User’s Group (Volumes 100 to 364).$40 

Updated! Plug-and-Play Linux by Yggdrasil Computing Version 1.1 (run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) . . . $35 

Mailer’s Lookup (9-digit ZIP codes by street address, distances between ZIP codes, phone locations; on-line tool, no source code).$35 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Updated! Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Updated! Walnut (Seek X11R6 and GNU (X11R6 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

Walnut Creek Usenet and Simtel Unix-C (600MB).$35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Works Internet Warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thrmpet, TCP/IP, FAQs, drivers, docs) . . . $35 

NEW! Walnut Creek FreeBSD (Berkeley 32-bit operating system for PCs; bootable).$35 

W&lnut Creek "Ibolkit for Linux (Slackware distrubtion and complete Linux archive).$35 

NE W! "Rans-Ameritech Slackware Linux (automated installation, lots of applications, extra kernels, Kanji, docs, FreeBSD).each $30 

NE W! "Racers and "Racings #1 (400 programs for raytracing, 850 images, 180 animations, fully-indexed, 489MB, July 1994).each $25 

Cheaper! Knowledge Media MegaMedia I and II (images, sounds, movies).each $25 

InfoMagic CICA Windows Archive (2 CD set, complete archive).$25 

InfoMagic Simtel 20 MSDOS Archive (2 CD set, source code but lots of other stuff too).$25 

NEW! InfoMagic Linux (2 CD set; complete source code from two Internet Linux sites; lots of contributed software).$20 

The Austin Code Works much more ... ask for catalog Voice: (512) 258-0785 

11100 Leafwood Lane FAX: (512) 258-1342 

Austin, Texas 78750-3587 USA http://works.zilker.net/ E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA/AMEX 

O Request 249 on Reader Service Card □ 
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File Systems and File I/O 

Windows NT supports multiple installable file systems. 
It currently supports FAT (the only file system supported 
for floppies), HPFS, and the new NTFS. NTFS supports 
many new features, including security and recoverability. 
Win32 provides lots of new functions for dealing with the 
file system and file I/O. There are functions for returning 
volume information, file copying and moving (finally!), file 
searching, getting and setting file time stamp information, 
and even monitoring for changes in the file system. 
There’s a new set of functions for creating (also used for 
opening), reading, and writing to files. These functions let 
you specify security attributes, access modes, and sharing 
modes. They also facilitate asynchronous file I/O, which is 
another important new feature of Windows NT. The lock 
and unlock functions let you lock and unlock regions of a 
file to prevent another thread or process from writing or 
reading to that section at the same time - you don’t have 
to open the whole file exclusively. This is particularly use¬ 
ful when multiple processes or threads want to access the 
same large file (such as a database). The book contains 
descriptions of most of these new functions and demon¬ 
strates many of them in the sample programs. 

Structured Exception Handling 

Structured exception handling is supported by the Win¬ 
dows NT operating system internally and shouldn't be 
confused with C++ exception handling. The actual syntax 
and implementation of structured exception handling, 
however, is somewhat compiler specific. Richter warns 
that some modifications may be required to the source 
code for compilers other than Microsoft's. Structured ex¬ 
ception handling allows you to define a block of code (the 
termination handler) that always gets called after another 


block of code (the guarded body) fin¬ 
ishes executing. You can also define 
a block of code (the exception han¬ 
dler) that gets called whenever an ex¬ 
ception occurs in the guarded body. 
The keywords __try, _finally, and 
_except are used to define the 
guarded body, termination handler, 
and exception handler, respectively. 
The book contains a fairly detailed 
description of the flow of control 
through these blocks of code and of 
how unwinding occurs. Using struc¬ 
tured exception handling with C++ is 
particularly problematic, but as the 
book uses the C programming lan¬ 
guage almost exclusively, these is¬ 
sues are not fully discussed. 

Unicode 

Unicode is a wide-byte character 
set supported by Windows NT. In 
Unicode all characters are 16-bit val¬ 
ues, as opposed to the 8-bit values in 
the ANSI character set. Windows NT 
uses Unicode strings internally but 
performs automatic conversion of strings from ANSI to 
Unicode whenever necessary. Using Unicode strings within 
your program may make it run faster since the system 
won't have to perform these conversions on the pro¬ 
gram's behalf. There are new Unicode-specific types and 
string functions, but if you use the generic versions you 
can compile your source code for either ANSI or Unicode. 
Use TCHAR for characters and LPTSTR for strings and use the 
versions of the string library referenced in TCHAR.H. If UNI¬ 
CODE (for the C runtime library string functions and types) 
and UNICODE (for the Win32 string functions and types) are 
defined, the program will be compiled for Unicode, other¬ 
wise it will be compiled for ANSI. Win32 also provides a 
set of routines for operating on Unicode strings and for 
converting back and forth between ANSI and Unicode 
strings. All of the sample programs accompanying this 
book can be compiled for either ANSI or Unicode by this 
method. 

Conclusion 

No one book can possibly cover all there is to know 
about Windows NT. A general overview of the architec¬ 
ture of Windows NT might have been appropriate for an 
advanced book. There is also no discussion of using the 
console (his focus was on GUI programming), the registry, 
security, remote procedure calls, or the new 32-bit graph¬ 
ics functions. However, although there were additional 
topics I would have liked to see covered, I can't argue 
with the set that Jeffrey Richter chose (the book is already 
700 pages, after all!). The topics that are included are rele¬ 
vant and are covered thoroughly and accurately. I recom¬ 
mend it for any serious Windows NT programmer. □ 
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Bug++ of the Month 

Mark Nelson 


Last month I looked at a compiler bug in Borland's 
C++ version 4.0 compiler. The compiler refused to process 
some legal C++ code, aborting with an error message. 
Bugs like this can be annoying, because the compiler 
won't let you do something that you know is legal. But 
you can generally find a workaround, as was the case 
with that problem. 

This month, I look at a much more serious problem in 
Microsoft's Visual C++ 1.5. In this case, the bug is in the 
C++ iostreams portion of the runtime library. What makes 
a bug like this so dangerous is that the compiler cleanly 
processes all the C++ code, and the iostreams code al¬ 
most always does what you expect it to. This makes it 
very easy to overlook the bug and let it slip into produc¬ 
tion code. 

I encountered this bug while using iostreams to read in 
ASCII data from an .ini file. Depending on what was 
stored in the file, I seemed to occasionally lose a charac¬ 
ter. I spent a lot of time fruitlessly looking for errors in my 
logic, before finally stumbling on the secret of this bug. 
The test program in vcbug.cpp (Listing 1) manages to flush 
the error out into the open. 

The test program is pretty simple. It takes the set of 
test data and writes it out to a test file. It then repeatedly 
calls fstream: :getline() to read the file back in a line at a 
time. If the program were working properly, you would 
expect to see output on your screen that looked like Fig¬ 
ure la. But when you compile and run this program using 
any of Microsoft's 16-bit C++ compilers, you instead see 
the results in Figure 1b. As you can see, there is a single 
byte missing from the second linel 

In order to make this problem appear, you need to 
have three critical components operating at the same 
time: 

• You must open an input stream in text mode instead 
of binary mode. Text mode for both the C and C++ 


runtime libraries takes care of automatically translating 
CR/LF pairs in a file to single '\n' characters in your 
input buffer. 

• Your data file must have a CR/LF pair that sits directly 
astride a 512-byte boundary. In the example in Figure 
1, each of the data lines except the last one is exactly 
64 characters (after the terminating *\n' is translated to 
a CR/LF pair). The extra byte in the final line makes the 
final file 51B bytes long, with the CR and LF sitting on 
either side of the first 512-byte buffer end point. 

• You must perform a tellgO operation on the file. 

Put these three ingredients together, and your file pointer 
magically advances ahead a single byte when you least 
expect it. 

When I first reported this bug on CompuServe, I didn't 
receive any acknowledgment from Microsoft. Fiowever, I 
did hear from another frustrated user who had reported 
the same bug almost a year beforel Oddly enough, he 
was writing exactly the same routine I was, an . ini file 
scanner. 

At this time the bug appears to have shown up in Mi¬ 
crosoft's knowledge base on CompuServe (GO MSKB), so 
we have every reason to hope it will be fixed in Visual 
C++ 2.0. Since Microsoft has indicated that development 
of 16-bit C++ compilers has more or less terminated with 
Visual C++ 1.5, you will probably need to work around 
this problem the same way I did: open all your fstream 
objects in binary mode instead of text mode, and manu¬ 
ally remove the '\r\n' pairs from your input data. 

Every bug you find, whether yours or a vendor's, 
should teach you something. I spent a lot of time debug¬ 
ging my code when I first encountered this problem, de¬ 
spite the fact that it worked properly with Borland, Syman¬ 
tec, Watcom, and GNU compilers. I just couldn't believe 
that such a commonplace use of iostreams could still be 
buggy in the third release of a C++ compiler. Instead, I 


Mark Nelson is a programmer for Creenleaf Software and a student at the University of Texas at Dallas. Mark is the author of The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from M8T Books. You can reach Mark 
on CompuServe at 73650,312. 
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spent a great deal of time and energy chasing down blind 
alleys. 

The lesson I learned was, to paraphrase the old say¬ 
ing: If it looks, walks, talks, and acts like a runtime li¬ 


Figures 1 a and 1 b Test program results 


Figure 1 a 
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Figure 1 b 
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brary bug, it probably is a runtime library bug. Work on 
proving that theory first, and if that doesn't work, then try 
the alternatives. □ 


Listing 1 Test program for iostreams bug 


♦Include <1ostrea«.h> 

♦Include <fstrea«.h> 

char test_data[] • 

"0123456789012345678901234567B901234567890123456789012345678901\n" 
"«123456789«123456789812345678981234567898123456789A12345678901 \n” 
"01234567890123456789012345678901234567890123456789012345678901\n" 
"01234567890123456789012345678901234567890123456789012345678901\n" 
"01234567890123456789812345678901234567890123456789012345678901\n” 
"01234567890123456789012345678901234567890123456789012345678901\n" 
"01234567890123456789012345678901234567890123456789012345678901 \n” 
"012345678901234567890123456789012345678901234567890123456789012\n"; 

nalnO 

{ 

fstrean test! "TEST.DAT, 1o$::Out ); 
test « test.data: 
test, closed: 

fstrean conf1g_f11e( "TEST.DAT”, 1os::1n ); 
char buffer! 257 ]; 
for ( : ; ) { 

conf1g_fl1e.tel 1g(): 

config_f11e.getl1 ne( buffer, 257 ); 

If ( conf1g_f11e.fa1T() II conf1g_ftle.eofd ) 
return 1; 

cout « buffer « "\n": 

) 

) 

/* End of File */ 


£> CD-ROM Software 

Walnut Creek CDROM 

• C Users' Group Library R01 $49.95 

Volumes 100 to 364. Source code for editors, disassemblers, compilers, interpreters, communications, games, tutorials, math libraries. Most 
code for MSDOS, much for UNIX and other systems. Disk includes the first three text editions of the CUC Directory: indexing and describing 
every file and reviewing major packages. 

• Libris Britannica R02 $69.95 

Public domain and shareware from PDSL, Sussex, for DOS: extensive sections on electronics, engineering, mathematics, medicine, ham 
radio, including the entire C Users' Croup UK archive. 

• Source Code R03 $39.95 

The Usenet archives, Simtel20 Unix-C archives, and a large collection of MSDOS source code. Simtel20 Unix-C are mostly complete working 
programs for archiving, benchmarks, databases, editors, file management, graphics, compilers and interpreters, printer utilities, communications, 
networking. MSDOS source is almost 2000 Zipped packages including Autocad utilities, editors, archivers and compression programs, 
emulators, compilers and interpreters; mostly C source code. 

• CICA Microsoft Windows R04 $24.95 

The entire CICA Windows Collection from Indiana University, hundreds of utilities, including shells, disk utilities, mouse and keyboard utilities, 
screen savers, backup/restore programs, performance monitors, diagnostics, data conversion programs, and games. 

• SIMTEL20 MSDOS R05 $24.95 

The entire Simtel20 MSDOS archive, 640 megabytes in 9000+ files. Many include source code, usually in C. Programming tools for APL, assembly, 
C, Pascal, Perl, Prolog, Smalltalk, etc. Communications utilities, BBS's, compression programs, shells, editors, graphics, menus, and games. 

• Garbo MSDOS/Mac R06 $24.95 

Contains the MSDOS and Mac archives from the University of Vaasa, Finland, almost all in English from Europe and America. MSDOS files are 
250 megabytes including programs for animation, archive utilities, BBS's programming tools, system utilities, business, science, education. 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Writing Windows Virtual Device 
Drivers 

David Thielen and Bryan Woodruff 
667 pages 

Addison-Wesley, 1994 
ISBN 0-201 -62706-X 
$39.95, includes 3.5" disk 



Windows virtual device drivers (VxDs) are 32-bit code 
entities that run in ring 0 (the most privileged mode of the 
Intel CPU) and have access to the large and varied API of 
the Virtual Machine Manager (VMM, the mini operating 
system that underlies enhanced-mode Windows). You can 
use VxDS for their primary purpose (fast device drivers 
that virtualize a single hardware resource for multiple ap¬ 
plications), but you can also use them to circumvent the 
normal restrictions of Windows and DOS programs (for ex¬ 
ample, to allow direct, fast data transfer between DOS and 
Windows programs). The main thing that will prevent you 
from tapping the power of VxDs is the lack of good docu¬ 
mentation on how to write them. Hence comes this book 
that hopes to 'give enough help so that developers will 
no longer be afraid to write VxDS.' 

The book starts with a skeletal VxD and follows with 
chapters on topics including VMM scheduling and services, 
memory management, nested execution, I/O trapping, IRQ 


virtualization, DMA, keyboard processing, writing VxDs in 
C, and debugging services. The two main examples are a 
VxD to virtualize the COM port, and Win-Link, a VxD to 
provide some DOS-to-Windows communication services. 
The ratio of code fragments to text is high. Some of the 
chapters have little new information to offer, such as the 
five-page chapter on using the virtual DMA device 
(VDMAD). While it appears quite hefty, most of the book 
(469 out of 667 pages) is a reprint of Microsoft's DDK 
documentation (the Virtual Device Adaptation Guide, to be 
specific), errors and all. However, the documentation is 
printed in a different order here, and entries are omitted, 
seemingly at random. For example, the book's VMM 
Macro Reference section omits Assert_VM_Handle, Con- 
trol_Dispatch, CallRet, and others. I could not figure out if 
certain items were omitted on purpose, or if these were 
accidents. 

There are more things to criticize about this book than 
I have space for here. The book does not seem to have 
been edited - the spelling errors begin in the preface 
('noone' is not a word) and continue throughout the 
book. The incomplete sentences were particularly irritating 
and frustrating. More importantly, terms and even acro¬ 
nyms appear in the middle of sentences with no prior 
definition or introduction. There is an index, but it does 
not index the Microsoft documentation, which is most of 
the book. The biggest example in the book, Win-Link, 
looks an awful lot like a commercial product that ap¬ 
peared and disappeared from the marketplace about a 
year ago. Of one portion of the code, the authors say 'It 
seems to work about 98 percent of the time.' The sad 
thing is that there is so little information on writing VxDs 
that this book is still better than nothing. 


Can't find a book mentioned in this review? You can purchase any book in print from Book Call, by calling (BOO) 255-2665 or faxing 
(203) 966-4329. 
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Windows Programming Power 
with Custom Controls 
Paul Cilwa and Jeff Duntemann 
510 pages 

Coriolis Group Books, 1994 
ISBN 1-883577-00-4 
$39.95, includes 3.5" disk 
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Custom controls have had a checkered past in Win¬ 
dows. At their simplest, they are nothing more than regis¬ 
tered window classes, easy to create, but painful for an 
interface designer to use. Microsoft created a custom con¬ 
trol interface that at least let custom controls give dialog 
editor users a reasonable interface to control their custom 
window style bits. While Borland extended that specifica¬ 
tion in a useful, backwardly compatible way (permitting 
multiple controls per DLL, dialog editor toolbar bitmaps for 
visual selection of custom controls, and more), Microsoft 
refused to support these extensions and let its own specifi¬ 
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cation stagnate for years. Meanwhile, Visual Basic intro¬ 
duced its own much more elaborate definition of a cus¬ 
tom control, called a VBX. VBXs were so much more suc¬ 
cessful than 'ordinary' custom controls that Microsoft and 
then Borland retrofitted their C compiler runtime libraries 
to support them. Most recently; as part of the latest at¬ 
tempt to revive its moribund OLE specification, Microsoft is 
defining the OLE custom control, apparently in the hope 
that it will inject some of the VBX momentum into OLE. 

Windows Programming Power with Custom Controls is a 
new book that covers both standard custom controls and 
VBXs. It shows you how to use C (the cover says 'C/C++' 
but, as usual, that really means just C) to create your own 
custom controls. The first chapter is entitled 'A New Way 
to Think about Windows Programming'; the philosophy 
lessons are confined to this chapter, which makes it easy 
to skip if, like me, you're not terribly interested in seeing 
text that contains the word 'paradigm.' The second chap¬ 
ter tackles the big picture of the history of custom controls 
and how they fit into Windows. With the third chapter, 
the technical meat of the book begins, describing a frame¬ 
work for constructing custom controls that support Mi¬ 
crosoft and Borland dialog editors, as well as the VBX in¬ 
terface. It does not try to cover Microsoft's emerging OLE 
custom control specification. Most of the rest of the book 
is devoted to example custom controls: a 3D panel con¬ 
trol, a virtual listbox control (holds 
more than 32Kb worth of data, but 
not more than 32K items), a pagelist 
control (demonstrates how to turn an 
ownerdraw listbox into a custom 
control), a database record browser 
VBX (illustrates integrating Visual Ba¬ 
sic database support into a VBX), a 
text file viewer (supports more than 
32Kb of data, but not more than 32K 
lines), a text file editor control, and a 
.ini file interface control. 

While poking around this book, I 
got the feeling the authors may not 
be expert in either C or Windows. In 
one spot, hex constants appear in 
Pascal format ($FFFE) in the text, a 
functional duplication of the ANSI 
standard offsetofO macro was con¬ 
structed for no stated reason, and the 
book contains a complete subseg¬ 
ment allocator even though this has 
been unnecessary for years (all C 
compilers' large-model mallocOs han¬ 
dle this for you). Despite exhortations 
early in the book to reuse existing 
code and avoid the not-invented-here 
syndrome, the authors later create 
their own file open/read/close func¬ 
tions because 'there are no standard 
C library routines for performing buff¬ 
ered, text-oriented file input - at 
least, none that we like.' While tak- 
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ing pains on one hand to avoid leaving a file open longer 
than the time required to process a single message (an 
ancient Microsoft proscription that most Windows pro¬ 
grammers ignore), the authors did not worry about open¬ 
ing a .ini file with _lopen() without first making sure that 
the Windows-cached .ini data was flushed to disk. There 
was no mention of 'control data,' a little-known means of 
defining an arbitrary array of initialization bytes for dialog 
custom controls. 

Pictures were not used where needed most - describ¬ 
ing the various data structures that Dialog Editor, Resource 
Workshop, and Visual Basic use in communicating with 
custom controls. You will not easily walk away with an 
in-depth understanding of, nor detailed documentation 
for, these interfaces. However, you will get working code 
examples that function with these interfaces. On the good 
side, the book shows you how to write custom controls 
that support both old dialog editor interfaces and the new 
VBX interface. What a great ideal The text is generally 
clear and accessible even to fairly inexperienced Windows 
programmers. In other words, the writing and editing are 
much better than the average Windows programming 
book. The custom control examples are not going to dis¬ 
place any professional custom control libraries, but their sim¬ 
plicity makes them easy to understand. If you have no expe¬ 
rience writing custom controls and you want to support the 
VBX style of custom control, this book is worth considering. 


leam how the PC architecture (wait states, bus width, the 
display adapter) affects speed. You can leam a lot of tips 
and tricks, such as when to use addressing instructions to 
perform arithmetic You end up not only with a better un¬ 
derstanding of how to write fast code, but with a better 
understanding of how the PC really works at a low level. 

There is at least one useful piece of optimization infor¬ 
mation you won't get from this book. The Pentium chip 
has some handy features that can provide very accurate 
timing and optimization information to assembly language 
programmers. Unfortunately, Intel has kept that informa¬ 
tion confidential (an amazingly shortsighted policy), and as 
a result, none of those features are used in this book. In¬ 
stead, Michael's 'Zen Timer' (it reprograms the timer chip) 
is used for benchmarking. 

I think the best thing about this book is not any spe¬ 
cific technique, but the constant message that you must 
measure in order to optimize. Hop onto the Internet or 
CompuServe sometime and find two or more program¬ 
mers talking about the most efficient way to do some¬ 
thing - the odds are that none of the participants have 
ever measured what they are talking about. It is just hu¬ 
man nature to postpone the tedious task of performing 
actual measurements and benchmarks. This book com¬ 
bats that tendency by showing over and over again that 
there is no substitute for actually making measurements. 
Anyone interested in writing optimal 80x86 assembly lan¬ 
guage should read this book. □ 


Zen of Code Optimization 
Michael Abrash 
469 pages 

Coriolis Group Books, 1994 
ISBN 1-883577-03-9 
$39.95, includes 3.5" disk 


Michael Abrash has been writing about optimal Intel 
assembly language programming for years, and this is his 
latest effort. This book reads like a conversation with 
someone who has spent a lot of time optimizing Intel as¬ 
sembly, punctuated by a series of code examples that 
start with the original code and move through succes¬ 
sively more optimal versions. Although Intel's 80x86 fam¬ 
ily is highly backwardly compatible, optimization tech¬ 
niques for the various chips are not so backwardly com¬ 
patible (optimization for the Pentium, in particular, is a 
whole new ballgame); this book covers the 8086 through 
the Pentium. Much of this book has appeared in Michael's 
excellent column in PC Techniques. Some portions are derived 
from Michael's first book, Zen of Assembly Language, which 
unfortunately went out of print quickly after it was released. 

What sorts of things can you learn from this book? You 
can learn how the CPU architecture affects speed. You can 
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New Products 

Industry-Related News & Announcements 


Use DDE to Control DOS Programs with RobinHood 


RobinHood is a new tool from WINGate Technolo¬ 
gies that gives Windows applications a DDE interface for 
controlling DOS programs. You can use RobinHood to 
launch and terminate any DOS program, send key¬ 
strokes to any DOS program, read data from a DOS 
screen, manipulate the cursor position on a DOS screen, 
or write data to a DOS screen. 


The RobinHood Developer's Toolkit will be available 
in September 1994 and costs $495. For more informa¬ 
tion, contact WINGate Technologies, High Street Court, 
Suite 303, Morristown, NJ 07960, (800) 946-4283 or 
(201) 539-2727;fax (201) 539-2838. 


Aardvark Creates VB Pretty Printer 

The Aardvark Pretty Printer is a new tool for printing 
formatted listings of Visual Basic source code. The pro¬ 
gram lets you use boldface. Italics, and different fonts 
and type sizes to distinguish key words, comments, and 
so on in the printed listings. You can also control indenta¬ 
tion, even if the input text was not indented. Rather than 
forcing you to print entire source files, the Aardvark 
Pretty Printer lets you select individual subroutines and 
functions for printing. Although it can take advantage of 


color printers, the software works with black and white 
printers as well. 

The Aardvark Pretty Printer costs $79.99, with an in¬ 
troductory price of $59.99, and includes a 90-day, 
money-back guarantee. For more information, contact 
Aardvark Software, Inc, 972 Sheffield Road, Teaneck, NJ 
07666, (800) 482-2742 or (201) 833-4355;fax (201) 
833-1216; CompuServe 70544,1372. 


AionDS Provides Business App Development Tool 


The Aion Development System (AionDS) is a visual de¬ 
velopment environment for building business process 
automation applications that require complex business 
logic. AionDS is typically used for applications such as 
product and sales configuration, credit card fraud detec¬ 
tion, production or personnel scheduling, product and 
service cross-selilng and underwriting. The new version 
of AionDS adds support for DDE for interapplication com¬ 


munication and ODBC for standardized database access. 
Applications developed with AionDS are portable across 
the platforms it supports (IBM MVS, AIX, SunOS, Win¬ 
dows, and OS/2) with few changes to application code. 

AionDS v6.4 for Windows and OS/2 PM costs $9,000 
per unit. For more information, contact Trinzic Corpora¬ 
tion, 101 University Avenue, Palo Alto CA 94301, (415) 
328-9595. 


Add CAD Support with cornerstone 

cornerstone is a developer's toolkit you can license 
to add CAD functionality to your Windows application. 
The product is written using the Watcom v9.5 32-bit C 
compiler and the standard Windows API. The graphics 
database is stored in ASCII format to make it easy for ap¬ 
plications to process or modify the CAD data. Archived 
databases are automatically compressed. The product of¬ 


fers standard Windows interface functions, including clip¬ 
board and MDI support. 

cornerstone costs $2800; distribution of software de¬ 
veloped under it entails a modest royalty arrangement. 
For more information, contact ARTTEK Systems, Inc, 10 
Inverness Drive, Suite 105, Englewood, CO 80112, (303) 
799-6559;fax (303) 790-2070; Internet: 
aritek@aritek.com; BBS (303) 799-1340. 
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Eiffel for Windows Ships for $49.95 


Eiffel is a language designed from scratch to support 
object-oriented software engineering. Personal Eiffel for 
Windows is a new version of the language, available for 
the first time for Windows 3.1. At $49.95, Personal Eiffel 
implements the complete language and comes with hun¬ 
dreds of precompiled library classes, but does not in¬ 
clude the ability to call C routines directly or generate a 
portable C package for cross-platform development. Per¬ 


sonal Eiffel features an incremental compiler and class li¬ 
brary support for fundamental data structures, algo¬ 
rithms, lexical and syntactical analysis, as well as class 
documentation and browsing tools. 

Personal Eiffel for Windows costs $49.95. For more in¬ 
formation, contact Interactive Software Engineering, Inc, 
270 Storke Road, Suite 7, Coleta, CA93I17,1805) 685- 
1006;fax (805) 685-6869. 


C Data Structure Lib Gets C++ Class Interface 


Windbase Software has released Memory Structures 
Library (MemSL) v2.0. MemSL provides code to create 
and manage data structures such as stacks, queues, de¬ 
queues, hash tables, binary trees, single and doubly- 
linked lists, circular linked lists, multi-dimensional 
dynamic arrays, trees, AVL balanced trees, threaded 
trees, sets, and graphs. MemSL also supports memory 
management routines that can trace allocations and deal¬ 
locations, and report common errors. The memory trac¬ 


ing is built into all the data structure routines to aid de¬ 
bugging. The C++ version of the library encapsulates the 
data structures and algorithms into a set of C++ classes. 

MemSL v2.0 costs $139.99 for DOS and UNIX-based 
systems, and includes portable ANSI C source code. For 
more Information, contact Windbase Software, Inc, P.O. 
Box 10115, Glendale, AZ 85318-0115, (602)561-8788; 
fax (602) 561-6490. 


Read/Write/Format Mac Floppies with MacAccess 


You can give your PC the ability to read, write, and 
format Macintosh 3.5" diskettes, with MacAccess vl .2. 
MacAccess transparently lets PC software access both PC 
and Mac floppies from the same floppy drive. The new 
version adds several features: support for PS/2s and the 
2.88 Mb floppy drive; a 'runtime' version of MacAccess 
which, as an alternative to the included TSR, lets you 
avoid loading MacAccess until you need to use It; easier 


Installation for networks - network drive letters remain 
unchanged; and better coexistence with CD-ROM drivers, 
allowing them to retain their original driver letters. 

MacAccess vl .12 costs $69. For more information, 
contact Hypm Technologies, Inc, 8522 National Boule¬ 
vard Suite 111, Culver City, CA 90232, (310) 842-9203; 
fax (310) 842-9014. 


New Macro Language Spans Windows Applications 


Applicat is a new macro language for Windows that 
can automate Windows tasks. The Applicat-based lan¬ 
guage engine (a.b.I.e.) lets you use any Windows com¬ 
mand in your macros, including those embedded in 
other applications. Applicat's Macro WorkBench lets you 
build a customized database of macro commands. You 
can also create buttons, menus, and dialog boxes. Pro¬ 
grammers can access the Applicat Data Base Engine. 

The program is available in both a developer's edi¬ 
tion and a professional edition. The professional edition 


adds the ability to distribute royalty-free .exes, as well as 
a menuing system that lets you define menus and attach 
them to mouse buttons, and a time manager that can 
launch Windows programs at specified times. 

Applicat Developer Edition costs $395; the Profes¬ 
sional Edition costs $1,495. For more Information, con¬ 
tact InControl Systems, Inc, 826 Office Park Circle, 
Lewisville, TX 75057, (800) 275-6380;fax (214) 219- 
6906; CompuServe 74147,3407; Internet applicat@on- 
ramp.net 


GX Effects Arrives for Windows 


Genus Microprogramming now offers both GX Effects 
v3.0, a DOS toolkit, and GX Effects vl .0 for Windows, a 
Windows toolkit; both kits let you add multimedia ef¬ 
fects, animation, and sound to programs written in al¬ 
most any language. GX Effects supports all display 
modes of the Hercules, CGA, EGA, VGA, and Super VGA 
display adapters, up to 1280x1024 in 16 million colors, 
including Mode X game resolutions. It comes with com¬ 
piler interfaces for C, Pascal, Basic, Fortran, assembly, 
and Clipper; the Windows version includes a DLL 
GX Effects provides transitional effects, such as 
weaves, slides, and spirals. You can animate sprites, mov¬ 
ing them across a background without flicker, placing 


them transparently on the screen or on offscreen virtual 
buffers. The DOS version of GX Effects supports 
Autodesk Animator Flic files. 

You can use the package to add music and sound ef¬ 
fects to programs. GX Effects for DOS provides a music 
definition language and a Sound Blaster voice file inter¬ 
face. GX Effects for Windows offers both MIDI and WAV 
support. 

GX Effects for DOS or Windows costs $199; source 
code for either package costs an additional $200. For 
more information, contact Genus Microprogramming, 
Inc, 1155 Dairy Ashford Suite 200, Houston, TX 77079, 
(800) 227-0918 or (713) 870-0737. 
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ToolBook v3.0 Adds Animation, Video Editing 


Asymetrix has released ToolBook v3.0 and Multime¬ 
dia ToolBook v3.0. The products are designed for devel¬ 
opers of visual software for front-ends and prototypes, 
CD-ROM publishing, and for authors of computer-based 
training, hypermedia, and information-kiosk applications. 

The products Include a number of enhancements. 
Viewer objects let authors display multiple pages simulta¬ 
neously, and to create mult- window applications, graphi¬ 
cal dialog boxes, palettes, pop-up windows, nested child 
windows, and more. The OpenScript language now exe¬ 
cutes up to 10 times faster. Users can import RTF files, re¬ 
tain the formatting, and add enhancements such as 
inline graphics, hypertext links, multicolor text, and so 
on. The products support 16-bit and 24-bit color graphics 
with automatic dithering when applications run on lower 
color-depth displays. You can create database tables and 


indexes with the built-in Paradox engine and dBASE sup¬ 
port. 

Multimedia ToolBook v3.0 provides a new stage ob¬ 
ject that displays MCI and non-MCI multimedia in a sin¬ 
gle window and automates the process of positioning 
and sizing visual media without the need for a script. A 
new scriptless animation tool lets you create path-based 
animation. The Media Packager automatically gathers 
and assembles all multimedia files for a given applica¬ 
tion, compresses them, and packages the application for 
distribution through the bundled Setup utility. 

ToolBook v3.0 costs $195 and Multimedia ToolBook 
v3.0 costs $895. Upgrades to ToolBook v3.0 cost $79; up¬ 
grading to Multimedia ToolBook v3.0 costs $495. For 
more Information, contact Asymetrix, (800) 448-6543; 

In Europe, (33) 1-46-92-24-95. 


MediaDeveloper v2.0 Offers VBX, DLL, C++ Class Interfaces 


Lenel Systems is now shipping MediaDeveloper v2.0, 
the latest version of their multimedia applications 
builder. MediaDeveloper now offers an OLE 2.0 automat¬ 
ion interface that makes it accessible to development en¬ 
vironments such as Visual Basic. It also offers OLE 2.0 
custom controls (OCXs), as well as VBX custom controls. 
You can also access MediaDeveloper v2.0 directly via its 
DLLs, from C, Paradox, FoxPro, or any tool that can call 
DLL functions. 

MediaDeveloper lets you define and play video, ani¬ 
mation, and audio segments. Hotspots can be defined 
over video, animation, graphics or text to trigger events 
and link sounds and voice to different objects. The prod¬ 
uct's database links let developers add video, graphics. 


animation and audio to their database applications. Us¬ 
ing OCXs, you can bind multimedia objects directly into 
BLOB fields of databases that support OLE 2.0. 

MediaDeveloper supports many graphics, video, and 
animation formats, including PhotoCD, AVI, indeo, .fli 
and .flc, and Apple's QuickTime for Windows. WAV, 
MIDI, and audio CDs are also supported. Developers can 
Integrate analog video and device control from laserdisc 
and videotape players using Lenel's MCI driver's kit. 

MediaDeveloper v2.0 costs $695. For more informa¬ 
tion or free demo disks, contact Lenel Systems Interna¬ 
tional, Inc, 290 Wooddtff Office Park, Falrport, NY 
14450-4212, (716) 248-9720;fax (716) 248-9185. 


Solomon Offers VB Support for Accounting Engine 


The Visual Basic Rapid Development Tool Kit 
(VBRDT) is a new tool for integrating Visual Basic applica¬ 
tions with Solomon IV for Windows, Solomon Software's 
Windows accounting software package. Solomon IV Is a 
client/server accounting information system for medium¬ 
sized businesses; it offers customizations without chang¬ 
ing source code. The VBRDT gives developers access to 
the design and development dictionaries used to de¬ 
velop Solomon IV, allowing them to create new, custom 
executables. The VBRDT provides access to Solomon IV’s 
Customization Manager, which allows users and develop¬ 
ers to customize any object property in any application 


screen without modifying source code; for example, you 
can move fields, add fields, hide fields, change field for¬ 
mats and captions, specify defaults, create lookup tables, 
or insert VBA-compatible code or OLE objects such as an 
Excel spreadsheet. 

The Visual Basic Rapid Development Tool Kit costs 
$2,995, and is sold only through authorized value-added 
resellers. You have to attend a two-day training course 
before purchasing the kit. For more information, contact 
Solomon Software, 1218 Commerce Parkway, P.O. Box 
414, Findlay, OH 45839, (419) 424-0422; 
fax (419) 424-3400. 


C-SIMPLEPLOT Provides Data Visualization for Windows 


Based on BUSS Ltd.'s original Fortran S1MPLEPLOT li¬ 
brary, C-SIMPLEPLOT is a set of routines for Microsoft Vis¬ 
ual C++ that lets developers incorporate data 
visualization into their Windows applications. 300 high- 
level C functions let you incorporate x/y and polar charts. 


contour, waterfall, surface plots, pie and bar charts. The 
package offers an identical API on Windows and Motif. 

C-Simpleplot costs £485. For more information, con¬ 
tact BUSS Ltd. 29, Campus Road, Bradford, U.K. BD71HR, 
+44274 309214;fax+44 274 370502. 


NetLicense Helps you Count Network Users 


Instance Corporation has released NetLicense 1.0, a li¬ 
cense monitoring toolkit for Windows applications. You 
can use NetLicense to prevent users from running unli¬ 
censed copies of their software on a LAN. NetLicense is a 
software-only (no hardware keys required) solution that 
is transparent to users unless they attempt to run two or 
more copies of the product with the same serial number. 


The protection is even valid across system platforms; ap¬ 
plications running on Win32 platforms are aware of 
those running on Winl 6 platforms and vice versa. 

NetLicense vl .0 costs $595. For more information, 
contact Instance Corporation, 22845 NE 8th Street 
Redmond, WA 98053-7299, (800) 494-0550 or 
(206)836-0111. 
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DLLs Provide Unit Conversion, Matrix Math, Trig, and Statistics 


MATHEMATICS DLL T00LK1TI is three DLLs that offer 
a variety of mathematical routines. The three libraries 
each come with a manual, compiled Interface (. tpJ) file 
for Pascal programmers, compiled library and object file 
for C/C++ programmers, and six months free support by 
phone, mail, or CompuServe. 

MATHEMATICS DLL TOOLKIT! (Alpha Set) offers 68 
functions In areas such as inverse trigonometric func¬ 
tions, mass and area moment functions, gamma related 
functions, hyperbolic functions, permutations, statistics, 
factorials, and primes. MATHEMATICS DLL TOOLKIT! 
(Beta Set) contains 11 functions for eigenvalues and 
eigenvectors, simultaneous equations, matrix multiplica¬ 


tion/transposition/addition/inversion, multiple regres¬ 
sion, and determinants. MATHEMATICS DLL TOOLKIT! 
(Gamma Set) contains 148 functions for unit conversion, 
covering units such as force, power, volume, length, pres¬ 
sure, viscosity, temperature, mass and molar flux, physi¬ 
cal constants, heat, energy and work, thermal 
conductivity, and so on. 

MATHEMATICS DLL TOOLKIT! (Alpha Set) costs $50, 
the Beta Set DLL costs $75, and the Gamma Set DLL 
costs $125. For more Information, contact Lone Wolf En¬ 
terprises, 1507 £ 53rd Street #438, Chicago, IL 60615; 
CompuServe 73353,121. 


C/C++ Source Browser Adds Visual Windows Support 


CC-RIDER is a source browsing and analysis tool for 
DOS, OS/2, and now Windows. The new visual mode 
browser Integrates with any Windows-based editor to 
provide source code navigation. CC-RIDER also supports 
text mode, operating inside any text-mode editor or de¬ 
bugger. The analyzer performs detailed analysis of any C 
or C++ code. All application symbols are stored in a data¬ 
base and cross-referenced according to type of use. The 
product supports all proposed ANSI C++ features, includ¬ 
ing nested classes, templates, runtime type identification 
(RTT1), and exception handling, with specific language 
support for the current versions of Borland, Microsoft, 
and Zortech C++. The C and C++ analyzers take advan¬ 


tage of Windows to provide background analysis, and 
they cache their database in extended memory for faster 
performance. 

New features include printed graphical class hierar¬ 
chy charts, function call tree diagrams, class nesting #in- 
dude file structures, a full API for accessing the database 
from your own DOS or Windows program, full ASCII sym¬ 
bol listings, automatic documentation taken from source 
code comments, a flat-file database export utility, and 
Windows Help and QuickHelp database output. 

CC-RIDER v5.0 costs $279. For more information, con¬ 
tact Western Wares, P.O. Box C, Norwood, CO 81423, 

(303) 327-4898. 


Embedded-System 8086 Debugging Comes to Windows 


Concurrent Sciences has released Soft-Scope and CSi- 
Locate for Windows. Soft-Scope is a source-level, remote 
debugger that supports both real- and protected-mode 
applications for the Intel 8086 family, including the new 
32-bit Intel386 EX embedded microprocessor. Soft-Scope 
runs on the host computer and provides a source-level 
user interface by communicating over the serial port 
with Csi-Mon, an embedded monitor that you run on the 
target board. The complete CSi-Mon source code is in¬ 
cluded and is royalty-free, so you can incorporate it into 
your product. 

Soft-Scope supports C/C++ compilers from Microsoft, 
Borland, Watcom, MetaWare, Symantec, and Intel. In ad¬ 
dition to being a remote debugger, it can serve as a soft¬ 
ware simulator when the target is another PC. Soft-Scope 


also supports real-time operating system debugging for 
applications using Intel's iRMX, Industrial Programmings 
MTOS-UX, and JMI's C EXECUTIVE. In-circuit emulators 
from Applied Microsystems and logic analyzers from Tek¬ 
tronix are also supported. 

CSi-Locate is a utility that takes a DOS or Windows ex¬ 
ecutable and converts it into a file that can be loaded 
into a target board via Soft-Scope or burned into ROM. It 
supports Microsoft, Borland, and Watcom C/C++ compil¬ 
ers. 

The Windows versions of Soft-Scope, CSi-Locate, and 
CSi-Mon together cost $2,195. Soft-Scope plus CSi-Mon 
costs $1,750. For more Information, contact Concurrent 
Sciences, Inc, 530 S. Asbury, P.O. Box 9666, Moscow, ID 
83843, (208) 882-0445;fax (208) 882-9774. 


FORCES Provides 00, Database-Independent Development 


EDIAS Software International has released FORCE-5, 
an object-oriented, database-independent application de¬ 
velopment environment. FORCE-5 uses most any SQL 
server to access data, and FORCE-5 applications can be 
independent of the data location. The same FORCE-5 ap¬ 
plication can be installed for one customer using Sybase 
and for another using Oracle without changing the appli¬ 
cation model. 

Developers use FORCE-5's on-screen designers to cre¬ 
ate the forms, menus, reports, procedures, and data struc¬ 


tures of the application, with no coding required. FORCE- 
5 developers can develop under Windows 3.1, OS/2 Pres¬ 
entation Manager, OSF/Motif, or OPENLOOK, and can 
install their applications in any of those environments re¬ 
gardless of where they were produced. 

For more information, contact EDIAS Software Inter¬ 
national LLC, 3141 Montana Drive, Prescott, AZ86301, 
(602) 771-2878;fax (602) 771-2105. 
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Readers' Forum 


We inadvertently omitted one complete sentence and 
part of another in last month's article "Extending the Actor 
Environment" (Richard Warren, W/DDJ, August 1994, pp. 
63-68). The first four sentences under the subhead "The Visual 
Implementation" on page 65, directly above Figure 3, should 
read as follows: 

All of this brings us to cas_clos.act (Listing 1). 

Windows 3.0 didn't really use the repaint flag parameter. 

3.1 does, but the method didn't change in the Actor 4.1 release. 
Two minor changes to the HindowsObject:moveHindow method cor¬ 
rect this problem. 

We apologize for any confusion this may have caused. 


Dear Ron, 

A colleague has been following your development of 
WUIMAN with interest. Could you please answer a ques¬ 
tion concerning your makefile from May 94? I am not cer¬ 
tain of some of the compiler options you use; specifically, 
does -p denote profiler? And does -3 denote 386 code? 
We are missing some issues of the article which may de¬ 
scribe which compiler you are using. Thanks in advance. 

Regards, 

Christian Adami 
apanix.apana.org.aulcadami@uunet.uu.net 

Sorry for the confusion; I need to add a README fie that 
makes life easier for people who grab this code. Here's the 
scoop: In order to use a single makefile with Borland, Microsoft, 
and Symantec C++ compilers, I use a little program I wrote 
(cc.exe) that provides a single command-line interface to all 
three compilers (it expects you to set an environment variable 
to tell it which compiler you are using). The cc option -p forces 
the use of C++ (as opposed to C), while -3 means the compiler 
can assume an 80386 or better (I figure no one uses standard 
or real mode any more). It also sets a variety of other options, 
some for convenience, some designed to get the compilers to 
accept legal C++ programs. 

If you don’t use cc.exe and the supplied makefile, make sure 
you use C++, large memory model, and define STRICT (the win¬ 
dows, h macro that enables strict type checking of Windows ob¬ 


jects). I think those are the main things to watch out for. The 
code has been compiled and run with Visual C++ vl.5, Borland 
C++ v4.0, and Symantec C++ v6.1. -rib 


Hi Ron, 

Your customer service is very poor. I sent the e-mail 
below on May 13 and didn't hear anything from them. 
I'm wondering if you can do anything about this. 

Thank you very much. 

Lei Zhou 

Email is a great convenience for things like ordering or cus¬ 
tomer service, but the one drawback is that it is not 100% reli¬ 
able. Your case is a good illustration of this - it is starting to 
look like you can send mail to me OK, but not to customer serv¬ 
ice (another address on the exact same machine!). I can't quite 
figure out how that could be, but then I have seen a great vari¬ 
ety of email problems that I could not figure out Although ROD 
has a relatively good connection with a backbone (uunet) for 
email, we have not infrequently hit problems where all our mail 
gets delayed for day or two, or a percentage of mail gets de¬ 
layed, or even (less frequently, thank goodness) a batch of mail 
is lost That is on top of the times when a customer sends us 
mail, our reply fails and produces a bounceback but we cannot 
figure out how to recast the address to get it through to you. 

The general point of all this is that, overall, email is fairly 
reliable (much more so than 5 years ago), but you still can’t 
count on it being 100% reliable. If you send us mail and don't 
get a reply, that almost always means that either your mail 
failed to reach us, or else our reply failed to reach you. One gen¬ 
eral strategy readers can use is to include a phone or fax num¬ 
ber or mailing address when sending mail to customer service. 
That way, if we know our reply did not reach you (i.e., we get a 
bounceback) we have a fighting chance to reach you some 
other way. If you're really having problems, you can also resort 
to sending email to my CompuServe account at 
70302.2566@compuserve.com and I will try to forward it to the 
appropriate address at ROD. 

Email is too convenient to give up just because of a few 
snags, and we intend to only increase our electronic services. 
This month's "From the Editor" describes an electronic alterna¬ 
tive to the Reader Service card, -rib 
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# from Walnut Creek CDROM 

r AII of these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs-quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: Classic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 

w/ GNU & X11. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/GNU & XI1 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows $39.95* 

♦shareware requires separate payment to authors if found useful 

Pick up the phone and Call Now! 
1 -800-786-9907 E 3BI 

1-510-674-0783 • FAX 1-510-674-0821 

email: orders@cdrom.com 

4041 Pike lane, Suite D-691 Concord, CA 94520 


□ Request 205 on Reader Service Card a 



Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 
See for yourself. Download your 
unlimited eval copy. 

Try a complete, free eval copy tonight! 

Our BBS: 206-935-5198 
NET: ftp.halcyon.com /local/wilson 
CompuServe: WINAPA, Sec. 15 
AOL: WindowWare 
Direct: 1-800-762-8383 
Wilson WindowWare, inc. 


□ Request 223 on Reader Service Card □ 


VB = me 

Visual Basic Standards 
and Practices 

This amazing book by J. D. Evans, Jr. 
defines a complete set of standards and 
naming conventions for use in managing and 
developing large applications with Visual 
Basic. Innovative, advanced diagramming, 
structuring, and programming practices 
unique to Visual Basic are described in 
detail. Required reading for 

PROFESSIONAL programmers! Book & 
Diskette: $39.90 + S & H $5.95 (UPS). 

ETN CORPORATION 

RR4, BOX 659 

MONTOURSVILLE, PA 17754-9433 
TEL: (717) 435-2202 FAX: (717) 435-2802 
CompuServe: 73641,242 


D Request 219 on Reader Service Card □ 


IPX VBX/DLL 
NetBIOS VBX 


These custom controls allow a Visual 
Basic developer to write distributed, 
client/server applications. A separate 
Windows dynamic-link library (DLL) is 
available for IPX. 

NetBIOS $99 
IPX/SPX $295 

NetWare 

xpl!lry 

10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 
Tel (501) 221-3600 • Fax (501) 221-7412 

□ FAX #1070 □ 



It runs with * 


SI_S(!OPK 

The PC RS-232 Analyzer 

SI_SCOPE a comprehensive serial 
data scope enables users to examine 
activity onanyseriallineatbaud 
rates up to 115k. Capture data to RAM 
and disk while viewing activity in 
selectable data formats including 
ASCII and EBCDIC. Pattern searching, 
microsecond timestamp accuracy, 
keyboard intervention, rr\acroe, and 
more! 

- Manual and Cable Included. 

- 30 Day Money Dack Guarantee. 

"Easy to use and a great tool!" 

- M. Hicks , Clement Industries. 

For Orders/Info Contact: 

Software Innovations Inc. 

63 Rock Cut Rd. 

Newburgh, NY 12550 
(914) 567-0805 
CompuServe 75013,3310 


□ Request 262 on Reader Service Card □ 



Opt-Tech Sort/Merge 


New - Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 

. (702) 588-3737 > 


□ Request 251 on Reader Service Card □ 
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Software Development 
Career Opportunities 

Nationwide openings in Windows 
/DOS Development, Test or Support 
Clients include Hardware companies, 
Software/Systems houses, and leading 
Manufacturing & Service firms who need 
your C/C++ expertise in Applications, 
Drivers or Operating System software 
development. Also have openings in 
software development/test of 80x86 
firmware, BIOS, UNIX or PC Network 
OS, and RDBMS. Send or fax 
confidential resume to: 

Alexander & Associates, Inc. 

P.O. Box 335 Granger, IN 46530 
219-271-7811 Fax:219-272-7566 
Nationwide Recruitment and Placement 
□ Request 303 on Reader Sen/ice Card □ 


OSETUP 


Windows Application 
Installation Tool 

"Create installations in minutes..." 

custom display/BMP • prompts • read-me dialog 
decompression‘multiple disks-huge files 
version & time/date checking‘font installdtion 
Program Manager group/icon creation 
Registration Database access*INI write/create 

onlv $49.95 

Call or write for more info: 

Celtech Software 

16900 Crenshaw Blvd. # 16 Eb 

Torrance, CA 90504 
310.769.1885 

info@celsoft.com •* 


□ Request 230 on Reader Service Card □ 
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To: ronb@rdpub.com 
Subject: assertions 

Dear Ron, 

I am a computer science student in Colorado and pro¬ 
gram in C++. I was reading your article in the Win- 
dows/DOS journal and would like to know, What is an 
assertion, what is an assertion error? Thanks. 

Hope to hear from you soon. 

Steve Aldrich 

General: Long ago, computer scientists dreamed of being 
able to prove whether or not software was correct. Unfortu¬ 
nately, that problem proved more or less intractable. However, 
while it's too hard to prove that an * arbitrary * program is cor¬ 
rect, it is feasible to * construct * programs so that they are fairly 
easy to informally prove correct Part of this process can involve 
asserting that certain conditions are true at certain points. For 
example, a square root routine cannot do its job if it is passed a 
negative number, so a provably correct square root routine 
might begin by asserting that its input is not negative. 


Specific: ANSI C defines (and C++ inherits) the header fie as- 
serth, which defines a macro called assertf) that you can use for 
implementing assertions. For example, you might say: 

♦Include <assert.h> 

float SquareRoottfloat Arg) 

{ 

assert(Arg > 0.0); 

i" 

If this routine were passed a negative number, it would abort 
with an error message like this: 

File "root.c", line 47, assertion failed: "Arg > 0.0" 

In other words, assertions are used to state that something 
"can't happen". Then, if that something actually does happen 
(which we all know occurs all too often), you will learn of it 
immediately. Hope this helps, -rib 
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FREE Report 


How to Eliminate 87% 
of C Programming Errors 
in less than 2 hours! 

This valuable report reveals secrets 
known by less than 5% of all profes¬ 
sional programmers. These little 
known but powerful techniques prev¬ 
ent almost 90% of all design and main¬ 
tenance errors with the guarantee that 
your compiled code will be virtually 
error free. Limited quantity available. 

Logic Technologies 

1 (619) 228-9653 , FAX 1 (619) 369-1185 
^6089 29 Palms Hwy. Ste 254-CJ. Yucca Valley, CA 92284J 

□ Request 276 on Reader Service Card a 
Page 84 — Windows/DOS Developer’s Journal 



ADVISOR 


DEVELOPERS CONFERENCE 


Experience the IVildest, Fastest, Most 
Exciting Software Competition 
and Conference on Earth! Nowhere 
else will you find this concentration of 
programming talent and cutting-edge 
development tools in one place! 

October 6-8.1994 
Durham. North Carolina 

Call (800)677-3542 
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DDE Manager 

For Visual C++™! 


Complete Dynamic Data Exchange 
capability for Visual C++! Our 
CDdeManager class suports 
simultaneous client/sever DDE 
transactions using DDEML for native 
data types, char or byte data, CString, 
and CObject-derived classes. No need 
to learn DDE, we've done all the work 
for you. Well commented source code 
on disk, examples and manual only $99 
(plus shipping and handling). 


Complete Source Code 
Step by Step Simplicity 
- = No Royalties 

Concept s 

I ncor porated Resource Concepts, Inc. 

111 W. First Street, Suite 748 
Dayton, Ohio 45402-1106 

Tech: (513) 461 -4606 Orders: 1 -800-434-1755 
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Add a Drag ‘n’ Drop Style 
Graphical Interface to your 
Visual C++ Application with 
Drag-it Class Library 

=> Concentrate on your application while 
Drag-it handles the graphics ! 

=> Create Custom Palette by drawing 
using Drag-it Builder I 

=> Track user’s actions at a higher level 
of abstraction than mouse moves! 

Only $495 including source 

To order call or fax today 
1-800-3-DRAG IT 

Perform^ 

6618 Daryn Dr., Westhills, CA 91307 
818-992-0840 fax: 818-347-9455 
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Data Enhancement System 

SIMPLEPLOT produces pictures of data 
Witt minimum effort. The library offers 
a vu'de range of facilities for droving: 
• cartesian and polar graphs 
• contouring and surface pictures 
• presentation graphics for high 
quality output 


Extensions include: 

• 4-d plotting • geographical 
projections • fast output for real time 
data display and animation 


SIMPLEPLOT offers: 

• System independence 

• Coverage of a wide range of 
platforms including V\indowsOOS 

• Use with C/C+ + and FORTRAN 


29 Campus Road, Bradford, U.K. BD7 1HR 
Tel: +44 274 309214 Fax+44 274 370502 
Email: sales@buss.co.uk 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


for Windows 3.x 


0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference. 

0 Control panel utility allows 
dynamic DLL configuration, 

0 WINDOWS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr. f Atlanta, GA 30350 

» TEL/FAX (404) 992-0536 

Also available at the Programmer's Connection! 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts Multimedia Wave (16, 8 & 

and save time with VFEdit®\ MS ADPCM), linear 16 & 
Record, crop, cut, copy, paste, unsigned 8, plus Dialogic 4 & 
mix, fade, echo, volume & 8 at any sample rate! 

more with your Dialogic™ 4. Scribe Transcription 
D4x/12x boards. Utility for DOS plays digital 

2. Add Voice Mail power to audio files in the background 

your MS Windows apps with without voice mail hardware! 
TI/F DLL our Tel I/F 5. Add Text-to-Speech 
Dynamic Link Library. capability to your apps with 

3. Audio Tool Box ™ VoxFonts ™, our "software 

converts to and from only" text-to-speech library! 


Order Now! 1-800-234-VISI 


I Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 19010 I 
Tel 215-747-5035/ BBS 310-392-6610/ Fax 1-800-234-FXIT 
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We Understand The 
Programmer's Mind 


When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT, OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

□Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641 -2900 
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Diskette I/O 

Code Libraries 
Device Drivers 
VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

Ay po ^ 5700 

L/ y tlvA Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 
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lOO'S OF COMPILERS 
INTERPRETERS 
with SOURCE 
LANGUAGE/OS.$34.95 

RECENTLY UPDATED .. 

LARGEST collection of Source for 
Compilers, Libraries, & Docs for computer 
languages and OS on CD ROM. 

GRAPHICS.$24.95 

Tools and applications w/ source 
for all graphic capabilities 

AUDIO.$24.95 

Tools and applications w/ source 
for all audio capabilities 

MULTIMEDIA.$24.95 

Tools and applications w/ source 
to cre ate interactive multime dia. 

For a catalog of all our titles or to order, cat: 

KNOWLEDGE MEDIA INC.™ 

(800) 78 CD ROM (916) 872-7487 FAX (916) 872-3826 
VISA and MASTER CARD accepted 
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BRIDG/T™ 

Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tel:(602) 991-7272 • Fax:(602) 483-7674 
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Design and test 
tabbed dialogs 
using our powerful dialog editor 
Dialog editor generates resource scripts 
Use with C, C++, PASCAL, etc. (not a VBX) 
Easily convert multiple dialogs into one 
tabbed dialog 

Upgrade existing applications quickly 
No royalties, with DLL source code 

Call today for free information 


SftTabs 1.0 (incl. DLL source code) $149 
S&H additional VISA/MC accepted 


mffM wstM 

(201) 366-9618 Fax: (201) 366-3984 

11 Michigan Ave Wharton, NJ 07885 
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TCP/IP Tools 


Why write low-level TCP/IP code when you 
can quickly and easily incorporate 
high-level components? 

iFiPw+a 



tWi iinrp ypfp 

PowerTCP lets you add TCP/IP protocols to 
your application without coding them yourself! 

VB & C/C++ Programming Interfaces 
Custom Development Available 


Phone: 315.841.8106 
Fax: 315.841.8107 


COMMUHICATWHS 

6 Occum Ridge Road 
Deansboro NY, 13328-1008 


Sales@dart.com 
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“I wish this was a 
Windows Application” 

You need the power and simplicity of 
ClearWin Plus™ with Salford's 32-bit 
C++ compiler for DOS, Windows 3.x and 
Win32 (Windows NT and Chicago). 
Using formats, ClearWin Plus offers an 
innovative approach to the problem of 
producing maintainable Windows code. 
Write a realistic prototype quickly in less 
than 100 lines of code with no previous 
Windows programming experience! 


Salford 

rSq/iuwie 



ASK FOR A FREE 
DEMO DISK 
TODAY 


Adelphi House. Adelphi Street, Salford M3 6EN, UK 
Tel: (+44) 0161 834 2454 Fax: (+44) 0161 834 2148 
Fax toll free from USA: 1 800 562 6875 
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To: Windows/Dos Developer's Journal 
Editor: Ron Burk 

Subject: General Questions on HOW to write a Virtual De¬ 
vice Driver for Windows 

I'm overwhelmed with junk I don't care about. I don't 
care about making a device driver that works in concert 
with DOS (device driver or TSR). I don't want to allow mul¬ 
tiple applications to attach to my driver - one at a time 
for simplification purposes - it only makes sense anyway 
since the device drivers are for VERY CUSTOM PC interface 
boards. I just want to get data to/from them as quickly as 
possible from a Windows 386 or better environment. I 
don't give a rat's furry behind about any stinkin' back¬ 
ward compatibility with DOS, or 80286 or 8086 machines! 
So why must every document regarding VxD's inundate 
me with all that garbage? Given my requirements can't I 
make some 'simplifying assumptions' for crying out loud? 
It's not enough I had to learn 700+ APIs for Windows, 
and more than double that for MSVC's Foundation 
Classes, I must now learn 300+ more for device drivers - 
and none of that tells me what I really want to know! 


How do I simply install an interrupt handler in a VxD and 
then communicate data buffers between the driver and 
the application level? Preferred method? Let the applica¬ 
tion allocate and lock the memory (not discardable, not 
moveable). Pass that address to the VxD at open time. 
The VxD, when interrupts are received, transfers data to 
the user's buffer and sets flags there and/or posts mes¬ 
sages to the client. The client may select 'polling' by poll¬ 
ing flags in the buffer filled up by the VxD or may use an 
'interrupt' approach, allowing the VxD to post a message 
when data is available or data has been transferred out 
completely. 

I just purchased Writing Windows Virtual Device Drivers, 
published by Addison Wesley. It is the worst piece of ED¬ 
ITING I've seen in a long time. It is replete with incomplete 
sentences, improper punctuation, and undefined jargon. 
The writer was lazy and the editor didn't make him get it 
right. (For example 'app' and 'jmp' are used constantly 
throughout the text, rather than 'application' and 'jump'. 
They should not be abbreviated. If 'jmp' is meant to refer 
to the assembly language instruction, it should be offset 
with a different typeface to indicate this.) The author 
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C and C++ DOCUMENTATION 



DICE IS LOOKING FOR 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 


DATA PROCESSING 
I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 

ONLINE Number 
515-280-3423 

Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
_ 515-280-1144 _ 
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Developer Jobs! 

1-800-231-5920 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
Specialists in R&D jobs for software engi¬ 
neers, SQA, product managers, etc. 
Nationwide contacts with both large and small 
companies including equity start-ups. Many 
clients develop and publish commercial soft¬ 
ware products. Most develop for Windows, 
NT, Macintosh, OS/2, and Unix based plat¬ 
forms. We also recruit in other leading edge 
technology areas such as PDA, low level and 
real-time, compilers, etc. Managed by gradu¬ 
ate engineers. Send resume or call to get an 
assessment of your marketability. Never a fee. 

Scientific Placement, Inc. 

Internet: Iej@scientific.com 

CompuServe: 71250,3001, AOL: davesmall 
SPI8, Box 19949, Houston, TX 77224 
(713) 496-6100 Fax: (713) 496-0373 
SPI8, Box 71, San Ramon, CA 94583 
733-6168, Internet: bge@spi.com 
Box 4270, Johnson City, TN 37602 
854-9444 Fax: (615) 854-9454 
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Sentry Spelling-Checker Engine S 


Add a professional-quality spelling 
checker to your C/C++ programs! 

■ 100,000-word dictionary 

■ 3 kinds of user dictionaries 

■ Source: $585 / Binary: $299 


ThesDB Thesaurus Library 


Add a professional-quality thesaurus 
to your C/C++ programs! 

■ 110,000 synonyms/20,000 key words 

■ Source: $585 / Binary: $299 


Both products feature: 

■ Example applications included 

■ Obj libs & Windows DLL included 

■ ANSI C source code available 

■ No royalties or runtime fees _ 


! 


WinfeH+ae Software. Jrtc. 

43 Rueter St. Nepean, Ont. Canada K2J 3Z9 

(613) 825-6271 FAX: (613) 825-5521 
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Spend your time writing your App 
...Not wading through 
DDK documentation!! A 

Hardware control for Win32™Apps 
- without the Device Driver Kit 
''Port I/O 


''Memory I/O 

''Interrupts 

Ask us about Alpha™, PowerPC™ and 
Chicago versions. 

BlueWater Systems 

(206)771-3610 
(206) 771-2742 Fax 
:j: : *WW 73514 132@compuserve.com 

£ M_J III | |V i;| NT version $595 
Royalty free runtime 


Visa,MC, Approved PO 
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.def problems? 
use psdef.exe! 


Psdef.exe maintains module definition files (.def) 
for your software projects. Automatically updates 
IMPORT and EXPORT sections of unlimited size 
between dynamically-linked C and C++ projects. 

- Essential for any evolving Windows™ project. 

- Eases porting to Win32* from UNIX? 

- Excellent for C++ object frameworks consisting 
of mutually interdependent DLLs. 

- Consolidates C++ template instantiations too! 

Supports compilers and linkers from 
Borland™, Metaware” Microsoft* 

Symantec™, & Watcom™. 

30 day money back guarantee. 


Philosopht Software 

PO Box 2152 • Cupertino • C A 95015-2152 
V/l■'408.481.0563 • CompuServe 71203,2451 
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The 

[TREASURE' 
HUNTERS 

In the world of software, it is j/ 
all too easy to lose a valuable 
treasure: by editing and saving t 
a program, overwriting a vital 
previous version. 

To prevent you from having to 
search in vain for buried treasures, 
ARIS VERSION TRACKING SYSTEM 
for Windows enables you to access 
and use previous program versions. 
AVTS. A gem of a program \ 

at a diamond price. 


1 2 ARIS 

Information-Systems 


Parkstr.2, 85646 Anzing, Germany \ 

Phone +49-8121-45624, Fax +49-8121-45625 ] 
From the USA, call 
Phone 01149-8121-45624 
, Fax 01149-8121-45625 
Email: CompuServe 100042,1707 
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IMWHelp 


UJindoui/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
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Add ZIP/UNZIP Power to your app's! 


f DvnciTIP Data 

I i/yilVIfclr Compression 
f Toolkit for Microsoft*'Windows' 

Finally there's an intelligent and easy 
way to incorporate reading and writing 
of industry standard ZIP files into your 
Windows programs, without having to 
"shell" to DOS. 

DynaZIP is a high-quality ROYALTY-FREE 
set of DLLs that give you a robust API for 
reading, testing, creating, writing, and 
updating your ZIP files. Supports C/C+ + 
and VB; includes source code for a 
high-quality Windows-based ZIP shell, 
comprehensive test/diagnostic tools, 
and full documentation/help system. 
Versions available for Win3.1 and NT, 

Now only $249.00 w/30-day 
no-risk guarantee! 

Call today, toll free: (800) 962-2949 


Inner Media. Inc.. Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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WINDOWS DEVELOPERS! 


Text-to-Speech 
Speech Recognition 
Speech Compression 


Software Development Kits 
now available for Windows 3.1 ! 


Set your products apart! 
Speech is the ultimate user-interface! 


& 


LERNOUT & HAUSPIE 


PRODUCTS 


ISPEECHl 


800 W. Cummings Park, Suite 3100, Woburn, MA 01801 
(617) 932-4118 x202 Fax: (617) 932-9209 

(800) 252-4999 x202 

CALL FOR MORE INFORMATION 


□ Request 121 on Reader Service Card □ 

September 1994 


I Does your company 

provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

WindowaT/POS 

□ developers journal 

Call 913-841 -1631 today for 
information about 
advertising opportunities in 
Windows/DOS Developer’s Journal. 

Advanced. Serious. 
Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine - Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 


M 

I. ,r 


ULTRA-485 

. «'+»• * 


Ei Nrijtyli! 15 


j 1 

Ife 




tr 


JLt.-,. : 


HMD! If 


RS-485 with Windows and OS/2! 

Operating System independent. No additional 
drivers required. 

Automatic RS-485 Driver Enable, looks like 
RS-232 port 1 

IRQ's 2-5, 7,10-12,15 supported 16550 buff¬ 
ered UARTs Standard 
Made in USA 

Part #3055 Price: $179.00 




Cp/]| FUFI Sealevel Systems 
l JLMLL-¥LL p o Box 830 

'Communications & I/O Liberty, SC 29657 


>,lnc. 


(803) 843-4343 
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Your program controls 
some important events... 

It MUST NOT BE STOLEN. 
Your Program MUST NOT 
BE STOPPED by an error 


" NO SECURITY KEY FOUND 

Software Protection Devices 

YOU NEED INTAR'S 


Hard Environment I 


Intar produces a wide range of copy protection devices. Our modules are 
designed to work in electrically and mechanically demanding environments 
and that Is why they are widely used In Finnish industry, (e.g. CNC servers, 
PC supervisor programs etc.) 

Prices for parallel port model start at $ 30 (qty 1), $22 (qty 100) 

__ Low-cost evaluation packages are availab le. 


INTAR Oy, P.0. Box 70, FIN - 00511 Helsinki, FINLAND 
Tel: +358 - 0 -148 4381, Fax: +358 -0-148 4382 


J 
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Sound & Vision Edition 

A hypertext / hypermedia Help Database Development Kit 
with two royalty free help engines and a help compiler with a 
built in cross reference tool. The current version is 10.0. 

ONE source generates help for MANY target formats like: 
Windows, OS/2, Microsoft Multimedia Viewer, THELP, 
DESQview/X, QuickHelp, PopHelp, word processors, text 
documents with table of contents, glossary and index. 

Write Once Help Many ! 

Supports Topics, PopUps, Links, Keywords, text formats, 
navigational and structural facilities, target code insertion, 
multiple module files, automatic Pascal/C/C++ reference 
generation, exception handling, graphics, sound, groups, 
multiple file target databases, Application Launch, user 
defined link templates, auto exports creation, and more. 

Get a demo version of HLPDK from CompuServe, Internet, 
PsL and other popular catalogs and BBS's. 

Order your copy from HyperAct, Inc. or PsL today! 


$50 

+S&H 


HyperAct, Inc. 

P.O.Box 5517, Coralville, IA 52241 
Tel/Fax (319) 351-8413 
CompuServe 76350,333 
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assumes the reader has already written many device driv¬ 
ers, or at least is INITIMATELY FAMILIAR with the Device 
Driver Kit (DDK) and the Application Programmer Interface 
(API) to the DDK. (This is apparent based on the jargon, 
for which there are no definitions in the text - and the 
'holes' in the descriptions, where the writer assumes the 
reader is 'all knowing;). Given all the typographical and 
grammatical errors, I'm concerned the examples may be 
just as error prone. Like Mary Gross of Saturday Night Live 
fame, Tm spiffin' mad' that I cannot find some accurate, 
GOOD tutorial information on implementing a device 
driver for custom hardware in windows. (It doesn't matter 
WHAT that custom device is or what it does. It can com¬ 
municate with Windows via I/O ports, hardware interrupts, 
DMA, and/or memory mapping only. Any generic descrip¬ 
tion of a Windows device driver can cover this - but none 
does!) 

Matthew J. W. Ratcliff 
72154.403@compuserve.com 

You raise a very good point. Magazines (and the only two 
books that discuss VxDS) have pretty much ignored the task of 


using VxDS for custom hardware. It is certainly an important 
topic, and W/DDJ is also guilty of passing it by. I agree that it 
should be possible to make it much easier to write a VxD for a 
custom board than it is right now, trying to pick up the DDK 
and wade through all those API functions. 

I can't point you to any remedies to this situation right now, 
but I know of two future events of interest First, WinRT is a 
toolkit for Windows NT that I believe is going to be ported to 
Chicago. From my initial inspection, WinRT looks roughly like a 
device driver that you can install to give your application access 
to arbitrary I/O ports and interrupts. For a lot of custom boards, 
this could allow you to totally avoid buying or understanding 
the DDK. However, it does not look like WinRT handles DMA, in 
which case that leaves out a class of custom hardware. Second, 
Karen Hazzah is working on a book that focusses on exactly 
this topic - writing Windows device drivers for custom hard¬ 
ware. I don't know when that book will arrive, but it is slated to 
be published by RBD, so it will probably be advertised in this 
magazine, -rib 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 
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"If you can’t See it or Measure it... 
you can’t understand it!" 

PinPoint™ 

two new Windows tools for 
one low price: $199 

• Visual Tracer™: See program 
execution flow in real time 

• Visual Profiler™: Measure function 
calling frequencies and execution 
times to 1ms. Easy-to-use graphical 
display. 

Works AUTOMATICALLY with C/C++ and 
Microsoft™ Visual Basic" 

Avanti Software, Inc. 

(800)329-8889x102 
International +1(415)329-8999 
FAX+1(415)329-8722 

90 day no-quibble guarantee 
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SmartHeap is an ANSI portable maHoc 
and new for DOS, Windows, NT, OS/2, 
UNIX and other platforms. Proprietary 
algorithms deliver speed Improvements 
up to 100X versus other commercial 
mallocs, especially for large heaps in the 
presence of virtual memory. SmartHeap 
localizes data structures in their own 
heaps. Plus it includes numerous fixed- 
size and handle-based APIs. Debugging 
facilities isolate leakage, overwrites, 
double-freeing, wild pointers, and many 
other errors to responsible file/line/pass 
count. Exceptionally reliable - used by 
a "who’s who" of commercial software 
publishers. No royalties. Source avail¬ 
able. 

CALL FOR FREE 

WHITE PAPER, BENCHMARKS, 
AND ERROR REPORTS 

MicroQuiU 

Software Publishing, Inc. 

800-441-7822 / 206-525-8218 
FAX 206-525-8309 

CompuServe: 70751,2443 
Internet: devtools@microquill.wln.net 



When you need 
Windows source, 
WinTodsm can deliver it! 

wrnroAsm 

Disassembles MS-Windows EXEs, 
DRVs, DLLs, and VxDs, by 
segment, range, or export. 

Labels exported and imported 
functions, VxD services, 
control proc, API entry, etc. 

Generates segment, export, 
import, and header tables. 

Supports batch-mode tagging of 
functions and data items 

RosToRC 

Decompiles resources to a RC file. 

Vextract 

Extracts VxDs from Win386. 


All for only $94.95! 
30-day Money-Back Guarantee 


Eclectic Software 

| 937 Jungfrau Court 
Milpitas.CA 95035 
(408) 262-3264 Voice/FAX 
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get me rastest imagin' 

. O O L 

with the most platforms, the most 
formats, and the only guarantee. 


AccuSoft is now the recognized provider of 
the highest quality imaging toolkits in the 
world. Our performance, compatibility, 
ease-of-use, service, and our AccuSoft Image 
Guarantee have earned us this distinction. 
Our libraries save you hundreds of hours of 
work and provide your application with a 
unique advantage: Guaranteed Format Support. 

Incredibly Easy To Use 

Our toolkits are so easy to use that it should 
take you less than an hour to add complete 
image import, export, conversion, display, 
printing and scanning support to your appli¬ 
cation. If you need to work at a lower level 
for special situations, we have functions for 
that, too! 

Story Behind The Guarantee 

Having offered this Guarantee for over two 
years, we have collected several thousand 
(weird, but perfectly valid) images. Now¬ 
adays we see very few problem images. If we 
do, the image is usually corrupted or invalid, 
yet we are able to provide solutions for these 
images as well. 

Guaranteed to read all raster 
images in existence in the 
supported formats. If you 
can find a valid image we 
don't read, send it to us and 
we will make it work. 


Performance Tuned By Experts 

We at AccuSoft have an unyielding commit¬ 
ment to achieving the highest performance 
possible for all our products. This, of course, 
means that your 
products will also 
achieve greater 
performance. 




AccuSoft is the Fastest! 


Support For All Platforms 

AccuSoft has versions for all major platforms 
including DOS, 32-bit DOS, Clipper, 
Foxpro, Windows™, Visual Basic®, 
Windows NT, OS/2, Chicago, Macintosh, 
and UNIX. We can also port to other sys¬ 
tems upon request. 

Complete Compression 

All forms of compression are supported 
including JPEG, Group III, Group IV, 
Packbits, LZW, Huffman, and more. Read 
any image format, then convert to any other 
format-with only two function calls! 

Features, Features, Features 

We provide a complete set of functions for 
printing, scanning, display, image processing 
and image handling. All printers and TWAIN 
scanners are supported with simple function 
calls. The image printing engine produces 
high quality output regardless of the printer. 
The display engine provides high-speed (up 
to 50 times faster than Windows) and high 
quality display for all types of images and 


display modes. Our image processing func¬ 
tions include zoom, pan, scroll, invert, 
rotate, resize, sharpen, blur, contrast, bright¬ 
ness, palette optimization, color reduction, 
matrix convolutions and much more. 

Visual Basic® Versions 

We have special versions for Visual Basic 
that provide all the power of the DLL in the 
form of a Custom Control. We even have 
the world’s only 32-bit VBX for Windows 
3.1. Extremely Fast! 

Pro Gold Versions 

Our Pro Gold libraries represent the most 
advanced performance and features available 
in the world. We have Pro Gold versions 
available for Windows 3.1 (no special hard¬ 
ware or drivers required), Mac, UNIX and 
others. When your application demands 
unbeatable performance, go with Pro Gold. 

Call Now To Order 


800 - 525-3577 

Risk-Free 30-day money back guarantee on all 16-bit products. 




High Performance Imaging 
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Get Inside WINDOWS! 
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Microsoft 

Windows 

Vision 3D Compatible Product 



Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with power 
and flexibility not found in any other Windows debugger! Soft-ICE/W 
allows you to debug at the systems or applications level or simply learn 
the inner workings of Windows. 

• Debug VxD's, drivers and interrupt routines at source level 

• Debug interactions between DOS T&SR's and Windows Apps 

• Debug programs in DOS boxes 

• Display valuable system information 

(from the total memory occupied by a Windows application, to the 
complex internal structures of Windows) 

Soft-ICE/W uses the 386/486 architecture to provide break point 
capabilities that normally require external hardware. Nu-Mega, which 
pioneered this technology with the introduction of its award winning 
Soft/ICE for DOS, now gives Windows programmers the same debug¬ 
ging power... and still at a software price. 

Own the debugger that combines the best "view" of Windows internals 
with the most powerful break points of any software debugger. 

Soft-ICE/W . . . Only $ 386 


"While you may choose to keep your own favorite debugger 
for simple work, Soft-ICE/W will soon become mandatory 
equipment for serious windows debugging." 

PC Magazine 
June 1992 


- WHAT THE EXPERTS ARE SAYING - 

"Soft-ICE for Windows is great! It helped me 
find, in fifteen minutes, a killer bug in a 
Windows virtual device driver that had 
eluded two people for several months, I 
can't see doing Windows development of 
any kind - whether writing Windows 
applications, device drivers, or even DOS 
programs that have to run under Windows - 
without it. In addition to being great for 
finding bugs, Soft-ICE for Windows has been 
essential for my work on a forthcoming book; 
on Undocumented Windows . Soft-ICE for 
Windows goes anywhere and does 
everything, so its essential for anyone who 
wants to poke around inside Windows 
Enhanced mode. DOS programmers will find 
it a perfect way to learn how the Windows 
DOS extender and DPMI server work, and 
how Windows interacts with DOS. Windows 
Enhanced mode is the hacker s paradise of 
the 90s, and Soft-ICE for Windows is the tool 
that every serious Windows or DOS hacker 
will need. Nu-Mega has done a brilliant 
job!" 

Andrew Schulman 

Software Engineer 

Editor. Undocumented DOS 

Coauthor. Undocumented Windows 


Call (603) 889-2386 
fax (603) 889-1135 
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u-Mega 

RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

TECHNOLOGIES INC 

603-595-0386 

24 HOUR BBS 


MICROSOFT WINDOWS IS A REGISTERED TRADEMARK OF MICROSOFT CORP. Solt-ICE/W AND CV/1 ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 
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